Window style attributes

Window style presentation attributes apply to a window.

Note: This topic lists presentation style attributes for a specific class of form element, common presentation style attributes can also be used for this type of element.
Table 1. Window style attributes
Attribute GDC GWC-JS GMA GMI
actionPanelButtonSize

Defines the width of buttons.

Values can be "normal", "shrink", "tiny", "small", "medium", "large" or "huge".

When using "normal" and "shrink", buttons are sized according to the text or image, where "shrink" uses the minimum size needed to display the content of the button.

Default is "normal".

 Yes No No No
actionPanelButtonSpace

Defines the space between buttons.

Values can be "none", "tiny", "small", "medium", "large" or "huge".

Default is "medium".

 Yes No No No
actionPanelButtonTextAlign

Defines the text alignment inside buttons.

Values can be "left", "center", "right".

Default is "left" when the button have an icon, "center" otherwise.

 Yes Yes No No
actionPanelButtonTextHidden

Defines the text visibility inside buttons.

Values can be "yes" or "no".

Default is "yes".

 Yes Yes No No
actionPanelDecoration

Defines the decoration of the action panel.

Values can be "auto", "yes", "no" and "dockable".

Default is "auto".

 Yes No No No
actionPanelHAlign

Defines the alignment of the action panel when actionPanelPosition is "top" or "bottom".

Values can be "left", "right" or "center".

Default is "left".

 Yes No No No
actionPanelPosition

Defines the position of the action button frame (OK/Cancel).

Values can be "none", "top", "left", "bottom" or "right".

Default is "right".

 Yes Yes No No
actionPanelScroll

Defines if the action panel is "ring" - that is, when the last button is shown, pressing on the "down" button will show the first one again.

Values can be "0" or "1". Default is "1".

 Yes No No No
actionPanelScrollStep

Defines how the action panel should scroll when clicking the "down" button, to shown the next visible buttons.

Values can be:
  • "line" (default): the panel will scroll by one line, and then show only the next button.
  • "page": the scrolling will be done page by page.
 Yes No No No
allowedOrientations

Defines possible orientations for modile device.

Values can be:
  • "all": Any orientations are allowed.
  • "landscape": Landscape orientation (the display is wider than it is tall).
  • "portrait": Portrait orientation (the display is taller than it is wide).
  • "landscape_reverse": Landscape orientation in the opposite direction from normal landscape.
  • "portrait_reverse": Portrait orientation in the opposite direction from normal portrait.
  • "landscape_all": Normal and reverse landscape orientations are allowed.
  • "portrait_all": Normal and reverse portrait orientation are allowed.
Default is "all".
Note: This attribute is supported at the Window level only by GMA.
 N/A N/A Yes No
border

Defines the border type of the window.

Values can be:
  • "normal" (default): the border is standard, with a normal window header with a caption.
  • "frame": only a frame appears, typically without a window header.
  • "tool": a small window header is used.
  • "none": the window gets no border.

On Mac platforms, using "tool" is not effective.

 Yes No No No
commentPosition

Defines the rendering for field comments.

Values can be:
  • "statusbar" (default): displays the comment in the window status bar.
  • "popup" will bring a window popup to the front; to be used with care, as it can annoy the end user.
  • "statustip" will add a small "down" arrow button that will show the popup once the user clicks on it; useful to display very long text.
  • "both" will display the comment text in a popup window and then in the status bar.
 Yes No No No
defaultTTFColor

Defines the default color to be used for TTF icons.

All icons displayed in the window using this style will by default get the color specified in the defaultTTFColor attribute.

The value for this attribute must and RGB specification or a named color as listed in Colors.

For more details about TTF icon usage see Using a simple image name (centralized icons).

 Yes Yes Yes Yes
errorMessagePosition

Defines the rendering of program errors displayed with the ERROR instruction.

Values can be:
  • "statusbar" (default): displays the comment in the window status bar.
  • "popup" will bring a window popup to the front; to be used with care, as it can annoy the end user.
  • "statustip" will add a small "down" arrow button that will show the popup once the user clicks on it; useful to display very long text.
  • "both" will display the comment text in a popup window and then in the status bar.
 Yes No No No
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 is "no".

 Yes Yes No No
formScroll

Defines if scrollbars should always be displayed when the form is bigger than the screen, or only when the window is maximized.

Values can be "yes" or "no".

Default is "yes".

 Yes No No No
ignoreMinimizeSetting

Defines if the stored settings "state=minimize" must be ignored when loading settings.

To be used when minimized windows should not be shown minimized when reopened.

Values can be "yes" or "no".

Default is "no".

 Yes No No No
iosRenderSystemActions

On iOS devices, indicates if default action views must be rendered with iOS standard icons and labels (yes, the defaut), or must use the text and image attributes of the corresponding action (no).

Values can be "yes" (default) or "no".

The iosRenderSystemActions is taken into account depending on the image action attribute usage:

  • If no image and no text attribute is used, GMI always uses the system action rendering, no matter what the value of iosRenderSystemActions is.
  • If an image attribute is used, the image is always used to render the default action view, no matter what the value of iosRenderSystemActions is.
  • If only a text attribute is used (no image attribute), iosRenderSystemActions defines if the iOS system action rendering is used (yes, the default) or if the text attribute is used (no)

See also Default action views decoration on iOS devices.

 N/A N/A N/A Yes
iosTintColor

On iOS devices, defines the color for items used in the navigation bar, toolbar, and some items in the forms (Buttons, SpinEdit, Radiogroups, and row checkmark and disclosure indicators in list views).

This style attribute does not apply to MENU with STYLE=dialog/popup.

 N/A N/A N/A Yes
iosNavigationBarTextColor

On iOS devices, defines the text color of the navigation bar.

 N/A N/A N/A Yes
iosNavigationBarTintColor

On iOS devices, defines the background color of the navigation bar.

 N/A N/A N/A Yes
iosToolBarTintColor

On iOS devices, defines background color of the toolbar.

 N/A N/A N/A Yes
iosTabBarTintColor

On iOS devices, defines the background color of the tab bar.

The iOS tab bar is created with a TYPE=NAVIGATOR window.

 N/A N/A N/A Yes
iosTabBarUnselectedColor
On iOS devices, defines the color of unselected items in the tab bar.
Note: This attribute works only for TTF icons. Use iosTintColor to define the color for selected tab bar items.

The iOS tab bar is created with a TYPE=NAVIGATOR window.

 N/A N/A N/A Yes
materialFABActionList

Defines a comma-separated list of action names that will be bound to the Floating Action Button (FAB button), on a device following the material design guidelines. To be used in conjunction with the materialFABType attribute. The order of the actions will define which action is triggered when the FAB button is tapped, and several matching actions are active.

The default list of actions is: "new,append,insert,update,edit"

 No No Yes No
materialFABType

Controls the Floating Action Button (FAB button), on a device following the material design guidelines.

Possible values are:
  • "single" (default) - the FAB button is shown and maps to the first active action defined in the materialFABActionList attribute.
  • "none" - no FAB button must be displayed.
 No No Yes No
menuPopupPosition

Defines the position of the automatic menu for "popup" menus.

Values can be:
  • "cursor" (default) - the popup menu appears at the cursor position.
  • "field" - the popup menu appears below the current field.
  • "center" - the popup menu appears at the center of the screen.
  • "center2" - the popup menu appears at the center of the current window.
 Yes No No No
messagePosition

Defines the rendering for program messages displayed with the MESSAGE instruction.

Values can be:
  • "statusbar" (default): displays the comment in the window status bar.
  • "popup" will bring a window popup to the front; to be used with care, as it can annoy the end user.
  • "statustip" will add a small "down" arrow button that will show the popup once the user clicks on it; useful to display very long text.
  • "both" will display the comment text in a popup window and then in the status bar.
 Yes No No No
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).
    Note: The windowType style attribute must be "modal".
  • "previous" the window is displayed at the same position (top left corner) as the previous window. (works as "default" when there is no previous window).
  • "center": the window is displayed in the center of the screen.
  • "center2": the window is displayed in the center of the current window.

For front-ends using stored settings, "field", "previous" and "previous" have higher priority than the settings.

Note: GBC: Only "field" (and "default") is supported.
 Yes Yes (see note) No No
ringMenuButtonSize

Defines the width of buttons.

Values can be "normal", "shrink", "tiny", "small", "medium", "large" or "huge".

When using "normal" and "shrink", buttons are sized according to the text or image, where "shrink" uses the minimum size needed to display the content of the button.

Default is "normal".

 Yes No No No
ringMenuButtonSpace

Defines the space between buttons.

Values can be "none", "tiny", "small", "medium", "large" or "huge".

Default is "medium".

 Yes No No No
ringMenuButtonTextAlign

Defines the text alignment inside buttons.

Values can be "left", "center", "right"

Default is "left" when the button have an icon, "center" otherwise.

 Yes Yes No No
ringMenuButtonTextHidden

Defines the text visibility inside buttons.

Values can be "yes" or "no".

Default is "yes".

 Yes Yes No No
ringMenuDecoration

Defines the decoration of the menu panel.

Values can be "auto", "yes", "no" and "dockable".

Default is "auto".

 Yes No No No
ringMenuHAlign

Defines the alignment of the ring menu when ringMenuPosition is "top" or "bottom".

Values can be "left", "right" or "center".

Default is "left".

 Yes No No No
ringMenuPosition

Defines the position of the ring menu frame for a MENU instruction.

Values can be "none", "top", "left", "bottom" or "right".

Default is "right".

 Yes Yes No No
ringMenuScroll

Defines if the focus can wrap in the ring menu default actions when pressing up or down keys.

Values can be "0" or "1".

Default is "1".

 Yes No No No
ringMenuScrollStep

Defines how the ring menu must scroll when moving to a next button that is not visible.

Values can be:
  • "line" (default): the menu will scroll by one line, and show only the next button.
  • "page", the scrolling will be done page by page.
 Yes No No No
sizable

Defines if the window can be resized by the user.

Values can be "yes", "no" or "auto".

With the GDC, when using "auto", the window becomes resizeable if the content of the first displayed form has resizeable elements, for example when using a form with a TABLE container or an TEXTEDIT with STRETCH attribute.

With GWC, 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.

Note: On Linux® and Mac platforms, most of window managers don't take into account sizable when it is set to "no".

Default is "yes".

 Yes Yes No No
startMenuAccelerator

Defines the shortcut keys to execute the selected start menu item, when the position is defined as "tree" or "poptree".

By default, "space", "enter" and "return" start the application linked to the current item.

 Yes No No No
startMenuExecShortcut2

Defines the shortcut keys to execute the selected start menu item, when the position is defined as "tree" or "poptree".

By default, "space", "enter" and "return" start the application linked to the current item.

 Yes No No No
startMenuPosition

Indicates the position of the start menu, when one is defined.

Values can be:
  • "none" (default): the startmenu is not displayed.
  • "tree": the start menu is displayed as a treeview, always visible on the right side of the window.
  • "menu": the start menu is displayed as a pull-down menu, always visible at the top of the window.
  • "poptree": the start menu is displayed as a tree view in a popup window that can be opened with a shortcut (see startMenuShortcut).
 Yes Yes No No
startMenuShortcut

Defines the shortcut key to open a start menu, when the position is defined as "poptree".

Default is "control-shift-F12".

 Yes No No No
startMenuSize

Defines the size of the start menu, when one is defined and the position is defined as "tree" or "poptree".

Values can be "tiny", "small", "medium", "large" or "huge".

Default is "medium".

Note: The size will also depend on the font used for the startmenu.
 Yes No No No
statusBarType

Defines the type of status bar the window will display.

See Statusbar types for all possible values.

Default is "default".

 Yes No No No
tabbedContainer

For the GDC, defines if the WCI container must display the child application windows in a folder tab.

For the GWC, this attribute specifies whether child applications are to be displayed inside the same browser window as the parent, or in a new window. WCI is not supported by GWC.

Values can be "yes" or "no".

Default is "no".

 Yes Yes No No
tabbedContainerCloseMethod

Defines the folder tab method of the container when tabbedContainer is set to "yes".

Values can be:
  • "container" (default): container gets a close button in the tab.
  • "page": each page has its own close button.
  • "both": each page and the container has its close button.
  • "none": no close button is shown.
 Yes No No No
thinScrollbarDisplayTime

Defines the display time (in seconds) of the automatic scrollbar displayed when scrolling on fixed screen array (a.k.a. "Matrix") and SCROLLGRIDs (for some front-ends). After the delay, the scrollbar will disappear. A value of zero specifies an infinite time: The thin scrollbar remains visible while the record list can be scrolled (i.e. during dialog execution).

Default is 1 second.

 Yes Yes No No
toolBarDocking

Defines if the toolbar is movable and floatable.

Values can be "yes" or "no".

Default is "yes".

 Yes No No No
toolBarPosition

Indicates the position of the toolbar, when a toolbar is defined.

Values can be "none", "top", "left", "bottom" or "right".

Default is "top".

 Yes No No No
windowMenu

Defines if the WCI container should display an automatic "Window" menu, with Cascade and Tile features, and list of child windows.

Values can be "yes" or "no".

Default is "no".

 Yes No No No
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 is "auto".

When value is "auto", the option is enabled according to 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.

 Yes Yes No No
windowOptionMaximize

Defines if the window can be maximized with a system menu option or window header button.

Values can be "yes", "no" or "auto".

Default is "auto".

When value is "auto", the option is enabled according to 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.

 Yes No No No
windowOptionMinimize

Defines if the window can be minimized with a system menu option or window header button.

Values can be "yes", "no" or "auto".

Default is "auto".

When value is "auto", the option is enabled according to 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.

 Yes No No No
windowState

Defines the initial state of a window.

Values can be "normal", "maximized" or "minimized".

Default is "normal".

 Yes No No No
windowSystemMenu

Defines if the window shows a system menu.

Values can be "yes", "no" or "auto".

Default is "auto".

When value is "auto", the system menu is enabled according to the window type.

Note: HTML5: Only "auto" is supported.
 Yes No (see note) No No
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 at the top of all other windows, typically used for temporary dialogs.
 Yes Yes No No
Related concepts
Windows and forms