Properties of the PUSH BUTTON Object

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar below the object, or when he/she resizes the window below and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the left of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the right of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar above the object, or when he/she resizes the window above and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Allows the object to be placed in focus.

Objects placed in focus are receptive to actions performed by the user using the keyboard and/or mouse.

CSS background-color style property. Defines the button's background color.

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_BACKGROUND_COLOR, CSS_BACKGROUND_COLOR_ACTIVE, CSS_BACKGROUND_COLOR_HOVER, CSS_BACKGROUND_COLOR_DISABLED).

CSS background-color style property. Defines the button's background color when pressed.

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_BACKGROUND_COLOR, CSS_BACKGROUND_COLOR_ACTIVE, CSS_BACKGROUND_COLOR_HOVER, CSS_BACKGROUND_COLOR_DISABLED).

CSS background-color style property. Defines the button's background color when disabled.

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_BACKGROUND_COLOR, CSS_BACKGROUND_COLOR_ACTIVE, CSS_BACKGROUND_COLOR_HOVER, CSS_BACKGROUND_COLOR_DISABLED).

CSS background-color style property. Defines the button's background color when hovering over it with the mouse.

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_BACKGROUND_COLOR, CSS_BACKGROUND_COLOR_ACTIVE, CSS_BACKGROUND_COLOR_HOVER, CSS_BACKGROUND_COLOR_DISABLED).

CSS border-color style property. Defines the border color.

This property is only available in Adelia Cloud mode.

CSS border-radius style property. Rounds the object borders.

This property is only available in Adelia Cloud mode.

CSS border-style style property. Defines the border style. If this property is defined, it overrides the classic border properties of the object.

This property is only available in Adelia Cloud mode.

CSS border-width style property. Defines the border size.

This property is only available in Adelia Cloud mode.

CSS color style property. Defines the button's text color.

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_COLOR, CSS_COLOR_ACTIVE, CSS_COLOR_HOVER, CSS_COLOR_DISABLED).

CSS color style property. Defines the button's text color when pressed .

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_COLOR, CSS_COLOR_ACTIVE, CSS_COLOR_HOVER, CSS_COLOR_DISABLED).

CSS color style property. Defines the button's text color when disabled.

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_COLOR, CSS_COLOR_ACTIVE, CSS_COLOR_HOVER, CSS_COLOR_DISABLED).

CSS color style property. Defines the button's text color when hovering over it with the mouse .

This property is only available in Adelia Cloud mode.

NB: if this property is selected, it overrides the theme. If you require specific effects when hovering over or activating the button, you need to define all the color properties (CSS_COLOR, CSS_COLOR_ACTIVE, CSS_COLOR_HOVER, CSS_COLOR_DISABLED).

CSS padding style property. Defines the margin between the object border and its content.

This property is only available in Adelia Cloud mode.

Allows the user to select the object by pressing the ENTER key even if the object is not in focus.

Objects with the DEFAULT_BUTTON property have a black border.

Note: The Java generator implements this property for the "Metal Look and Feel" only.

Button display mode.

Note: This property is only implemented in Cloud or Windows Client generation.

Character font used to display the text in the object.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

• • 1: Normal (no special style)
  • 2: Strikethrough
  • 16: Italics
  • 256: Bold
  • 4096: Underlined

The style value to be specified in the string can either be one of the above values or else the sum of values other than 1.

The different script values are as follows:

Notes:

The size, style and script must be compatible with the chosen font. The Windows system font selection dialog box, accessible via the graphical object's Properties pages, provides a guide for selecting coherent values.

The "Underlined" style is only considered by the Java generator if MULTILINE = *TRUE.

Specifies the first object in a group of objects. A group of objects is defined by its first object and includes all the following objects (following the object sequence) until the first object in another group is reached. The user can use the arrow keys to change focus from one object to another within the same group.

Height value of the object.

Triggers the display of a help field when the user clicks on the object.

Defines how the graphical control is adjusted when the window is resized horizontally.

Note: This property is not implemented in Java and Mobile generation.

Height of the icon in the case of a button with an "icon" representation (text and image properties entered).

If neither the icon height or width are entered, the size of the image is calculated in relation to the button height. If only one of the two properties is entered, the icon size is calculated so as to maintain the image proportions.

NB: if the icon is larger than the button, the image will not be displayed fully and the text may not be visible.

Width of the icon in the case of a button with an "icon" representation (text and image properties entered).

If neither the icon height or width are entered, the size of the image is calculated in relation to the button height. If only one of the two properties is entered, the icon size is calculated so as to maintain the image proportions.

NB: if the icon is larger than the button, the image will not be displayed fully and the text may not be visible.

Splits the text of the object over two or more lines when the character string is too long to fit on a single line in the object.

Static name of the object.

Spacing (in pixels) between the button icon and the text in the case of a button with an "icon" representation (text and image properties entered).

Allows the object to be placed in focus using the keyboard (TAB key or SHIFT+TAB).

Character string displayed inside the object.

The text is displayed on a single line.

This property specifies whether or not the ToolTip is displayed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Background RGB color of the ToolTip associated with the object.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*65536 + G*256 + R . Some values are predefined via the constants listed below.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the bottom edge of the ToolTip and the bottom of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

By default, the ToolTip is displayed to the bottom-right of the mouse pointer, possibly overlapping part of the button. If the ToolTip is center-adjusted, it is displayed below the button, centered relative to it.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Used to delete (or retain) any ampersand characters ('&') in the ToolTip text. This property is useful where the text is from a menu option.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Length of time (in ms) during which the ToolTip is displayed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Character font used to display the ToolTip text.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

• • 1: Normal (no special style)
  • 2: Strikethrough
  • 16: Italics
  • 256: Bold
  • 4096: Underlined

The style value to be specified in the string can either be one of the above values or else the sum of values other than 1.

The different script values are as follows:

Notes:

The size, style and script must be compatible with the chosen font. The Windows system font selection dialog box, accessible via the graphical object's Properties pages, provides a guide for selecting coherent values.

This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the left-hand edge of the ToolTip and the left of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Maximum width (in pixels) allowed for the ToolTip. By default, the ToolTip text is displayed on a single line. To display the text on more than one line, you must either specify a maximum width for the ToolTip or else enter a text containing carriage returns (characters with the decimal values 13 and 10).

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

When the ToolTip is permanently active, it is displayed even if the button is placed in a window other than the currently active window.

Notes:

This property is not implemented by the Java generator.

It is not available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the right-hand edge of the ToolTip and the right of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Text used in the ToolTip. If this text is not specified during the layout design phase, the button will not have a ToolTip when it is executed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

RGB color of the ToolTip text associated with the object.

The property's value corresponds to a RGB color. Each color has a red, green and blue component in the range [0 ; 255]. The value of the resultant color is calculated as follows: Color = B*65536 + G*256 + R . Some values are predefined via the constants listed below.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Pause (in ms) between the moment the mouse pointer stops over the button and the moment the ToolTip is displayed.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Distance (in pixels) between the top edge of the ToolTip and the top of the text.

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

Defines how the graphical control is adjusted when the window is resized vertically.

Note: This property is not implemented in Java and Mobile generation.

Visibility of the object.

Only visible objects can be placed in focus.

Width value of the object.

X coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

Y coordinate value of the object's position relative to the area covered by the window, page or pane.

The reference point (origin) is the top left corner of the object.

• Page:
  Events of the PUSH BUTTON Object
• Page:
  Methods of the PUSH BUTTON Object
• Page:
  Properties of the PUSH BUTTON Object
• Page:
  PUSH BUTTON (Visual Adelia Context)