Window style attributes: Basics
Basic presentation style attributes for window elements.
Style attributes listed in this page are general and supported on several front-end types, when the platform allows it. See also other pages about window style attributes.
forceDefaultSettings
Indicates if the window content must be initialized with the saved positions and sizes. By default, windows are reopened at the position and with the size they had when they were closed. You can force the use of the initial settings with this attribute. This applies also to column position and width in tables.
Values can be "yes"
or "no"
(default).
position
Indicates the initial position of the window.
"default"
(default): the windows are displayed depending on the window manager or browser rules."field"
: the window is displayed below the current field (works as"default"
, when current field does not exist). ThewindowType
style attribute must be "modal
". For more details, see Field-anchored picklist."center"
: the window is displayed in the center of the screen.
For front-ends using stored
settings, "field"
and "previous"
have higher priority than
the stored settings.
sizable
Defines if the window can be resized by the user.
Values can be "yes"
(default), "no"
or "auto"
.
- On a normal window, the behavior is applied to the form instead of the window. When set to
"no"
, the form content is not stretched, even if the form contains stretchable items. - On a modal window, when set to
"no"
, the end-user cannot resize the modal window.
tabbedContainer
(deprecated)
tabbedContainer
will be deprecated
and replaced by a new style attribute.
Values can be "yes"
or "no"
(default).
When a window of an application uses tabbedContainer=yes
, every application
except the one hosting the tabbed container is embedded in a tab container.
When using this style attribute, the front-end sidebar is replaced by the StartMenu, which is mandatory when
tabbedContainer=yes
.
See also Containers for program windows.
thinScrollbarDisplayTime
Defines the display time (in seconds) of the automatic scrollbar displayed when scrolling on fixed screen array (a.k.a. "Matrix") and SCROLLGRIDs. After the delay, the scrollbar disappears.
A value of zero specifies an infinite time: The thin scrollbar remains visible while the record list can be scrolled (during dialog execution).
A negative value specifies that the scrollbar must always be hidden.
Default is 1 second.
toolBarPosition
Indicates the position of the toolbar, when such element is defined by the form.
"top"
(default): Toolbar is displayed at the top of the window."bottom"
: Toolbar is displayed at the bottom of the window."none"
: The toolbar is not displayed."chrome"
: Action views are displayed in the frame of the browser surrounding the HTML content. See Action views in chromebar.
windowOptionClose
Defines if the window can be closed with a system menu option or window header button.
Values can be "yes"
, "no"
or "auto"
(default).
When value is "auto"
, the option is enabled depending on the window type.
This attribute may have different behavior depending on the front-end operating system. For example, when no system menu is used, it may not be possible to have this option enabled.
windowState
Defines the display state of the window container when using the GDC front-end.
The windowState
style attribute is defined for BDL WINDOW
objects. However, it applies to the window container, following the windowState
style attribute
defined for the first WINDOW
displayed by the program.
- The following
windowType
options apply, unless stored settings have a different window state registered, or when stored settings are disabled:"normal"
(default): The window container displays in normal state (first window/form layout defines the window container size)"fullscreen"
: The window container uses the whole screen."maximized"
: The window container is maximized."minimized"
: The window container is minimized.
- The following
windowType
options always apply, even when stored settings are active and define a different window state:"forceFullscreen"
: The window container uses the whole screen."forceMaximized"
: The window container is maximized."forceMinimized"
: The window container is minimized.
windowType
Defines the basic type of the window.
"normal"
(default): Normal windows are displayed as typical application windows."modal"
: Modal windows are displayed over all other windows, typically used for temporary dialogs.