WindowPlacement Attribute
Data Type: smallint
4GL Access: RW
The WindowPlacement attribute specifies the default position for the frame's window when the frame is first called or opened.
If there is only one monitor connected to the computer, using WP_PRIMARYSCREENRELATIVE or WP_VIRTUALSCREENRELATIVE has the same behavior. The same is true for WP_PRIMARYSCREENCENTERED and WP_VIRTUALSCREENCENTERED. On UNIX, using multiple monitors is not supported; using one or the other has the same behavior.
Valid settings are:
WP_INTERACTIVE
Places the window on the screen in a position that minimizes the overlap with the parent frame.
WP_INTERACTIVE is equivalent to, and behaves like, WP_FLOATING.
If you specify this setting, the window manager chooses the location.
WP_SCREENCENTERED
Centers the window on the screen. By default this is equivalent to WP_PRIMARYSCREENCENTERED unless environment variable II_W4GL_USE_VIRTUAL_SCREEN is set to TRUE; in that case this value is equivalent to WP_VIRTUALSCREENCENTERED
WP_SCREENRELATIVE
Positions the window relative to the upper left corner of the screen, using the values in the WindowXLeft and WindowYTop attributes as coordinates. By default this is equivalent to WP_PRIMARYSCREENRELATIVE unless environment variable II_W4GL_USE_VIRTUAL_SCREEN is set to TRUE; in that case this value is equivalent to WP_VIRTUALSCREENRELATIVE.
WP_PARENTRELATIVE
Positions the window relative to the parent frame, using the WindowXLeft and WindowYTop attributes as coordinates. Because the first frame in the application has no parent, WP_PARENTRELATIVE for the first frame is treated as WP_SCREENRELATIVE.
WP_PARENTCENTERED
Centers the window relative to the parent frame. Because the first frame in the application has no parent, WP_PARENTCENTERED for the first frame is treated as WP_SCREENCENTERED.
WP_FLOATING
Places the window on the screen in a position that minimizes the overlap with the parent frame
WP_PRIMARYSCREENCENTERED
Centers the window on the primary monitor
WP_PRIMARYSCREENRELATIVE
Positions the window relative to the upper left corner of the primary monitor, using the WindowXLeft and WindowYTop attributes as coordinates
WP_VIRTUALSCREENCENTERED
Centers the window on the virtual monitor
WP_VIRTUALSCREENRELATIVE
Positions the window relative to the upper left corner of the virtual monitor, using the WindowXLeft and WindowYTop attributes as coordinates
Descriptions of system constant values and their numeric equivalents are listed in
Window Placement Settings).
Note: OpenROAD honors the WindowPlacement attribute except when a frame is placed entirely off the screen. When this occurs, OpenROAD places part of the frame's title bar on the screen.
Last modified date: 06/25/2024