ImageState (Property)

The image associated with a button.
The image of the cursor in a slider.
The image associated with the button of a sidebar pane.
The image associated with the button of a tab pane.
Versions 17 and later
The image associated with the Rating control.
New in version 17
The image associated with the Rating control.
The image associated with the Rating control.
Versions 18 and later
The image associated with the grouping of a Ribbon control.
New in version 18
The image associated with the grouping of a Ribbon control.
The image associated with the grouping of a Ribbon control.

For the radio buttons and the check boxes, ..ImageState is used to find out the number of animation steps.

For the images in a format other than the animated GIF, the animation is defined via a drawing board. The animation steps correspond to the number of drawing lines in the image sheet.

Remark: Each image drawing corresponds to a status:

of a button, sidebar pane or tab pane. The drawings must follow a specific order: Normal, Pressed, Grayed, Focus and Rollover.
of a slider. The drawings must follow this order: Normal and Pressed.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 18 and later

This property is now available in Windows Store apps mode.

New in version 18

This property is now available in Windows Store apps mode.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

Example

// Modify the image associated with the "BTN_Help" button
BTN_Help..Image = "C:\MyImages\Help.gif"
// Initialize the number of drawings in the image associated with "BTN_Help"
BTN_Help..ImageState = 3

Syntax

Finding out the number of drawings found in the image associated with a control Hide the details

<Current number of drawings> = <Control name>..ImageState

<Current number of drawings>: Integer

Number of drawings found in:
The image associated with the button. This number is included between 1 and 5.
The image of the cursor in a slider. This number is included between 1 and 2.
The image associated with the button of a sidebar pane. This number is included between 1 and 5.
The image associated with the button of a tab pane. This number is included between 1 and 5.
Versions 17 and later
The image associated with the Rating control.
New in version 17
The image associated with the Rating control.
The image associated with the Rating control.
For the Check Box and Radio Button controls, number of animation steps.

<Control name>: Character string (with or without quotes)

Name of control to use.

Modifying the number of drawings found in the image associated with a control Hide the details

<Control name>..ImageState = <Number of Drawings>

<Control name>: Character string (with or without quotes)

Name of control to use.

<Number of Drawings>: Integer

New number of drawings found in:
The image associated with the button. This number is included between 1 and 5.
The image of the cursor in a slider. This number is included between 1 and 2.
The image associated with the button of a sidebar pane. This number is included between 1 and 5.
The image associated with the button of a tab pane. This number is included between 1 and 5.
Versions 17 and later
The image associated with the Rating control.
New in version 17
The image associated with the Rating control.
The image associated with the Rating control.
For the Check Box and Radio Button controls, new number of animation steps.

Remarks

..ImageState only applies to:

buttons,
the sliders,
the sidebar panes,
tab panes,
the check boxes and radio buttons,
Versions 17 and later
the Rating controls.
New in version 17
the Rating controls.
the Rating controls.
Versions 18 and later
the groups of a Ribbon control.
New in version 18
the groups of a Ribbon control.
the groups of a Ribbon control.