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.

Values can be:
  • "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). The windowType 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".

Note:
  • 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)

Important:

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.

Values can be one of:
  • "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.

topmenuDesktopRendering

Indicates the rendering of the topmenu on desktop front-ends, when such element is defined by the form.

Values can be one of:
  • "classic" (default on desktop): Topmenu is displayed as a tree of options on top of the window, all items of the first group appear horizontally in the topmenu bar.
  • "sidebar" (default on mobile): Topmenu is displayed on the left of the window, when pressing the dedicated hamburger button. Rendering is compacted to show topmenu option levels one by one.
This style attribute applies on window topmenus, but has an impact on global topmenus as well.

topmenuMobileRendering

Indicates the rendering of the topmenu on mobile front-ends, when such element is defined by the form.

Values can be one of:
  • "classic" (default on desktop): Topmenu is displayed as a tree of options on top of the window, all items of the first group appear horizontally in the topmenu bar.
  • "sidebar" (default on mobile): Topmenu is displayed on the left of the window, when pressing the dedicated hamburger button. Rendering is compacted to show topmenu option levels one by one.
This style attribute applies on window topmenus, but has an impact on global topmenus as well.

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.

Values can be:
  • 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.

Values can be:
  • "normal" (default): Normal windows are displayed as typical application windows.
  • "modal": Modal windows are displayed over all other windows, typically used for temporary dialogs.