Common style attributes

Common style presentation attributes apply to any graphical element, such as windows, layout containers, or form items.

Important: Common style attribute apply to basic layout elements such as containers (Group) and form widgets (Label, Button, Edit, CheckBox). Depending on the front-end platform, common style attributes typically do not apply to advanced graphical elements such as TopMenu or ToolBar, especially when such widgets can be configured with the user interface theme of the front-end platform. Consider using common style attribute only for elements inside the form layout.
Table 1. Common style attributes
Attribute GDC GBC GMA GMI
backgroundColor

Defines the color to be used to fill the background of the object.

For possible values, see Colors.

Default is no value (default background color of the object, or inherited background color).
Note: To set the background color of GMI/iOS specific GUI elements like toolbars, tab bars and navigation bars, use the ios*TintColor attributes for Windows.
 Yes Yes Yes Yes (see note)
border

Defines the border for the widget.

If value is "none", it removes the border.

Default is no value (the widget gets its default appearance).

This attribute especially applies to widgets such as Image, Edit, ButtonEdit, Button.

 Yes Yes No Yes
fontFamily

Defines the name of the font.

For possible values, see Font families.

Default is no value (default object font or inherited font).

 Yes Yes Yes Yes
fontSize

Defines the size of the characters.

For possible values, see Font sizes.

Default is no value (default object font or inherited font).

 Yes Yes Yes Yes
fontStyle

Defines the style of characters.

For possible values, see Font styles.

Default is no value (default object font or inherited font).

 Yes Yes Yes Yes
fontWeight

Defines the weight of the characters.

Possible values for font weights depend on the front-end native font names, see Font weights for details.

Default is no value (default object font or inherited font).

 Yes Yes Yes Yes
imageCache

For form items displaying an image, defines if the image can be cached or not by the front end.

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

If value is "yes" the front-end can cache the image locally. By default, images for image fields are not cached and images for form items (Button, TopMenu item, Toolbar item) are cached.

 Yes No No No
localAccelerators

For form items using shortcuts, defines how the widget must behave regarding keyboard accelerators.

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

If value is "yes" (default), the local accelerators have higher priority.

Ex: "HOME" key moves the cursor to the first position.

If value is "no", the application accelerators have higher priority.

Ex: "HOME" key selects the first row of the current array.

The following keys are managed "locally" if the attribute is defined with "yes".

TEXTEDIT: left, right, up, down, (control+)home, (control+)end, (control+)backspace, (control+)delete

EDIT, BUTTONEDIT, DATEEDIT, etc: left, right, home, end, (control+)backspace, (control+)delete

TABLE, TREE: (control+)left, (control+)right

 Yes No No No
showAcceleratorInToolTip

Defines if the accelerator key(s) for an action is shown in the tooltip of the corresponding action view (Button, Toolbar Item, and so on.)

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

If value is "yes" the tooltip shows the accelerator key(s) after the action name, between brackets. By default, the tooltip only shows the action name.

 Yes No No No
textColor

Defines the color to be used to paint the text of the object.

For possible values, see Colors.

Default is no value (default object color or inherited color).
Note: In GMI, textColor affects the widgets they are defined on, not the labels in the form used to display the widgets. It is also used to set the tint of checkbox, radio group (horizontal), and spin edit.
 Yes Yes Yes Yes (see note)
textDecoration

Defines the decoration for the text.

Values can be "overline", "underline" or "line-through".

Default is no value (default object font or inherited font).

 Yes Yes No No