Platforms to show: All Mac Windows Linux Cross-Platform
method, Window, MBS REALbasic MacOSX Plugin (MacOSX), class Window, Console safe, Plugin version: 3.0, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: An alternative title for a window on Mac OS X.
Notes:
Used for the window menu.
You may use it for windows with the same name, but different entries in the standard window menu.
This property works only if CarbonLib 1.1 or newer is present.
(Read and Write computed property)
global method, Window, MBS REALbasic Util Plugin (Window), Mac OS X: Works, Windows: does nothing, Linux x86: Does nothing, Feedback.
Function: Returns true if floating windows are visible
Example:
if not AreFloatingWindowsVisibleMBS then
ShowAllFloatingWindowsMBS
end if
Notes: You should hide floating windows before showing a dialog.method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 8.1, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window uses asyncron dragging.
Notes:
This window is marked so that the window server will drag the window automatically. Your application should not call DragWindow for this window, else it would confuse the heck out of the drag (it would fight with the window server for control). This attribute is ignored (async drag is not used) if your window is grouped with other windows in a window group that has the kWindowGroupAttrMoveTogether attribute. Available for all windows on Mac OS X 10.3 and later.
Seems to have no effect for RB 2008r2.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 8.1, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window can be visible before login.
Notes:
This window can be made visible prior to user login. By default, in Mac OS X 10.5 and later no windows can be visible before a user logs into the system; this protects the user against certain types of malicious use of insecure applications. However, some software, such as input methods or other accessibility software, may need to deliberately make windows available prior to user login. Such software should add this window attribute to its windows. Available for all windows in Mac OS X 10.5 and later.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window supports live resizing.
Example:
mainwindow.CanLiveResizeMBS=true
Notes: Available for all windows on Mac OS X.
You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
class, Window, MBS REALbasic Win Plugin (Win), class Window, Console safe, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Extends Realbasic's Window Class.
Notes: In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
method, Window, MBS REALbasic Util Plugin (WinTrans), class Window, Plugin version: 5.0, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Clears transparency of a window.
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Returns true if this window can be collapsed.
Example:
MsgBox str(window1.CollapsableMBS)
Notes: Collapseable windows are the normal document windows.
You can't collapse dialogs or floating windows well.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
Added Cocoa support in plugin version 10.0.
Some examples which use this method:
global method, Window, MBS REALbasic Util Plugin (Window), Mac OS X: Works, Windows: does nothing, Linux x86: Does nothing, Feedback.
Function: Collapse all windows.
Example:
CollapseAllWindowsMBS true
Notes: Like pressing alt while you click on the collapse button with the mouse.Some examples using this method:
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Returns true if this window is collapsed. You can set it.
Example:
mainwindow.collapsedMBS=false 'show window
Notes: Collapseable windows are the normal document windows.
You can't collapse dialogs or floating windows well.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
Added Cocoa support in plugin version 10.0.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic MacOSX Plugin (CGImage), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Draws into a window's dock tile.
Notes:
Returns a Mac OS error code (-1 for function not available and 0 for okay).
If clearbeforedrawing=true then the area is cleared before the image is drawn.
Some examples which use this method:
method, Window, MBS REALbasic MacOSX Plugin (MacOSX), class window, Console safe, Plugin version: 6.2, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether Expose will hide this window.
Example:
window1.ExposeHiddenMBS=CheckBox1.Value
if window1.ExposeHiddenMBS then
StaticText1.text="yes"
else
StaticText1.text="no"
end if
Notes: Requires Mac OS X 10.4 to work.
Returns false on any error.
Default value is false for all document windows.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 8.4, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Queries the window structure size.
Example:
// a Finder like Zoom from the top left of the screen to the center
dim h As Integer
dim i As Integer
dim w As Integer
dim x As Integer
dim y As Integer
dim l As Integer
dim r as IntegerRectMBS
dim e as integer
dim TheWindow as window // the window
e=TheWindow.GetWindowBoundsMBS(x,y,w,h)
x=(screen(0).Width-300)/2
y=(screen(0).Height-300)/2
w=300
h=300
e=TheWindow.SetWindowBoundsMBS(x,y,w,h)
TheWindow.top=y
TheWindow.left=x
TheWindow.height=h
TheWindow.width=w
//Center the window
x=0
y=0
w=0
h=0
call TheWindow.TransitionWindowMBS(nil,1,1,x,y,w,h,False,5.0)
Notes: Returns -1 on Windows or Linux.
Returns a Mac OS error code.
method, Window, MBS REALbasic MacOSX Plugin (MacOSX), class Window, Console safe, Plugin version: 5.1, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Switches the transparent grow box on and off.
Notes:
Only Mac OS X 10.2 and only on Composite windows.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.
Function: Decides whether the window has a border.
Example:
mainwindow.HasborderMBS=false ' Remove border
Notes: This property has only an effect on Windows. The window needs to be redrawn before the change is visible (for example move it). This option removes the title bar. HasCaptionMBS removes even more.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 7.4, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.
Function: Whether the window has a caption (a title bar)
Example:
Window1.HasCaptionMBS=false
Notes: This property has only an effect on Windows. The window needs to be redrawn before the change is visible (for example move it).
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window has a CloseBox.
Example:
mainwindow.HasCloseboxMBS=false 'remove closebox
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window has a Collapsebox.
Example:
mainwindow.HasCollapseBoxMBS=false 'remove Collapsebox
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 7.4, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Returns true if this window can be resized horizontally and vertically.
Example:
mainwindow.HasFullZoomButtonMBS=false 'remove resizebox
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Returns true if this window can be resized horizontally.
Example:
mainwindow.HasHorizontalZoomButtonMBS=false 'remove resizebox
mainwindow.HasVerticalZoomButtonMBS=false
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.
Function: Returns true if this window has a Maximize Button.
Example:
mainwindow.HasMaximizeBoxMBS=false 'remove Maximize button
Notes: This property has only an effect on Windows. The window needs to be redrawn before the change is visible (for example move it).
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.
Function: Returns true if this window has a Minimize Button.
Example:
mainwindow.HasMinimizeBoxMBS=false 'remove Minimize button
Notes: This property has only an effect on Windows. The window needs to be redrawn before the change is visible (for example move it).
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window has no shadow.
Example:
mainwindow.HasNoShadowMBS=true 'remove shadow
Notes: Available for all windows on Mac OS X. This attribute is automatically given to windows of kOverlayWindowClass.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
Added Cocoa support in plugin version 10.0.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 7.4, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: For Document, Floating, and Utility windows, this attribute allows you to hide the title bar of a window.
Notes:
For Mac OS X 10.4 or later.
You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 8.1, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether a metal window has rounded corners.
Notes:
Indicates that this window will have rounded bottom corners. By default, a window has squared corners, and the assertion of this bit turns on rounded bottom corners for the window if the window has a bottom bar (set with HIWindowSetContentBorderThickness). If the window does not have a bottom bar, this bit is ignored. If the window is metal, the RoundBottomBarCornersMBS attribute will be ignored, as that type of window defaults to rounded corners and controls the squareness with the TexturedSquareCornersMBS attribute.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window has the title bar on the side.
Example:
mainwindow.HasSideTitlebarMBS=true 'moves titlebar to side
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Only good for floating windows.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 7.4, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.
Function: Whether the window has a system menu inside the title bar.
Example:
Window1.HasSystemMenuMBS=false
Notes: This property has only an effect on Windows. It will disable the system menu and also the minimize, maximize and close buttons. The window needs to be redrawn before the change is visible (for example move it).
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window has a toolbar button.
Example:
mainwindow.HasToolbarButtonMBS=true 'shows Toolbar Button
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
The Button is showed on next redraw of the window frame.
Use the CarbonWindowsEventsMBS class to receive events when the button is pressed.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Returns true if this window can be resized vertically.
Example:
mainwindow.HasHorizontalZoomButtonMBS=false 'remove resizebox
mainwindow.HasVerticalZoomButtonMBS=false
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
global method, Window, MBS REALbasic Util Plugin (Window), Mac OS X: Works, Windows: does nothing, Linux x86: Does nothing, Feedback.
Function: Hides all floating windows windows.
Example:
HideAllFloatingWindowsMBS
Notes: You should hide floating windows before showing a dialog.method, Window, MBS REALbasic Util Plugin (Window), class Window, Plugin version: 3.2, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: The window will hide itself if full screen mode is entered by an application or another window.
Example:
Window1.HideOnFullScreenMBS=true
Notes: This window is automatically hidden during fullscreen mode (when the menubar is invisible) and shown afterwards. Available for all windows. This attribute is automatically given to utility windows.
You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Plugin version: 3.2, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: The window will hide itself if the application goes to background.
Example:
Window1.HideOnSuspendMBS=false
Notes: This window is automatically hidden on suspend and shown on resume. Available for all windows. This attribute is automatically given to floating windows.
You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Plugin version: 3.2, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Can be used to control whether mouse clicks are ignored for this window.
Example:
Window1.IgnoreClicksMBS=true
Notes: Whether this window never receives mouse events, even in areas that are opaque. Instead, clicks on the window will be passed through to windows beneath it. Available for all windows on Mac OS X 10.2 and later.
You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
Works only on Mac OS X 10.2.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
Added Cocoa support in plugin version 10.0.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic MacOSX Plugin (MacOSX), class window, Plugin version: 8.7, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: This method causes a window's shadow to be recalculated.
Notes:
InvalidateShadowMBS is not typically used by applications. However, it may be useful for applications with customized window frames that change shape dynamically; in this case, after the application has drawn the new window shape, the window shadow must be recalculated to follow the new window shape.
This method causes the window shadow to be immediately recalculated and redrawn based on the current contents of the window's back buffer. For best performance and visual appearance, you should follow these steps when invalidating a window shadow: disable updates with DisableScreenUpdatesMBS, draw, flush, invalidate the shadow, and enable updates. For a compositing window, after invalidating any views that should be redrawn, you will need to explicitly draw and flush using HIWindowFlush, rather than waiting for the event loop to draw and flush the window, because you cannot disable updates or invalidate the window shadow if drawing is done via the event loop.
Requires Mac OS X 10.4 and should do nothing on 10.3.
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Decides whether the window is inside the Window menu.
Example:
mainwindow.InWindowMenuMBS=false 'remove from window menu
Notes: This window is added to the standard Window menu. Available for document windows.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.
Function: Returns true if this window is inside the taskbar.
Example:
MsgBox str(window1.IsIconicMBS)
Notes: If you set IsIconic to true the window is minimized and if you set it to false the window size and position is restored.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 7.4, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window uses the Metal appearance.
Notes:
Available for document windows on Mac OS X 10.2 and later, and for floating windows on Mac OS X 10.3 and later. Drawers can also be metal, but dynamically adjust their appearance based on their parent window's appearance; it is not necessary to specify this attribute for a metal drawer.
You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 7.4, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window receives mouse events even for areas of the window that are transparent (have an alpha channel component of zero).
Example:
Window1.IsOpaqueForEventsMBS=false
Notes: Available for windows of kOverlayWindowClass on Mac OS X 10.0 and 10.1, and available for all windows on Mac OS X 10.2 and later.
You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class window, Plugin version: 7.4, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Whether this window is resizeable.
Example:
Window1.IsResizableMBS=false
Notes: You can read the state on Mac Classic, but you can only change it on Mac Carbon.
Returns false on any error.
Use GrowBoxTransparentMBS on Composite Mac OS X windows to enable the transparent grow box.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
method, Window, MBS REALbasic Util Plugin (Window), class Window, Plugin version: 3.2, Mac OS X: Works, Windows: Does nothing, Linux x86: Does nothing, Feedback.
Function: Returns true if the window is zoomed.
Example:
MsgBox str(window1.IsZoomedMacMBS)
Notes: Requires Mac OS 8.5 or newer.
Seems not to work correctly on RB 5.5.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
Added Cocoa support in plugin version 10.0.
(Read and Write computed property)
method, Window, MBS REALbasic Util Plugin (Window), class Window, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.
Function: Returns true if this window has been maximized.
Example:
MsgBox str(window1.IsZoomedMBS)
Notes: If you set IsZoomed to true the window is maximized and if you set it to false the window size and position is restored.
In Realbasic 2005 and newer you need to use self. in front of the method as the propertyname alone is not accepted.
(Read and Write computed property)
Some examples which use this method:
The items on this page are in the following plugins: MBS REALbasic MacOSX Plugin, MBS REALbasic Util Plugin, MBS REALbasic Win Plugin.