|
When the Button style is set to Image button, an image can be used for the button.
The text for the button is defined according to the value of the Format property, and the button image is defined by the associated variable or the Default Image file property if no variable is associated with the control.
This image must contain four or six images (depending on what is set in the Number of Images in the Push Button Image List setting) that correspond to the four or six different states of a push button:
-
Parked on – This only happens when the push button is associated with a variable and you tab into it.
-
Pressed
-
Disabled
-
Normal – This is the section that is displayed to the user, when the button is not being parked on and it is enabled.
For six images you also have these options:
-
Hot Track – Displayed when the mouse hovers over the push button.
-
Default Button – Displayed when the push button is set as the forms' default button. A default button is a push button that is activated when the user presses the Enter key. The default push button is not activated when editing a multi-line control.
During runtime, Magic xpa decides which one of the four or six images is displayed.
The maximum dimension of each single image in the image list is 256x256, so when using the 6 state image for example, the image dimensions can be up to 1536x256 pixels. You must specify the file name for the image file either in the Data property as a variable or as an expression. The Rich Client Image List File Name property (or GUI Default Image File property) displays the specified image only in the Studio.
See also:
How Do I Create Image Buttons?
How Do I Combine Image and Text on a Button?
| 