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 a group in a Ribbon control.
New in version 18
The image associated with a group in a Ribbon control.
The image associated with a group in a Ribbon control.
Versions 27 and later
The image associated with a menu option.
New in version 27
The image associated with a menu option.
The image associated with a menu option.

In Radio Buttons and Check Boxes, the ImageState property is used to get 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 set.

Remark: Each image drawing corresponds to a state:

For Button controls, sidebar pane, tab pane, menu option, etc.: the drawings must follow a specific order: Normal, Pressed, Grayed, Focus and Rollover.
For Slider controls: 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 17 and later

This property is now available for WEBDEV sites.

This property is only available for managing the images found in the Rating controls.

New in version 17

This property is now available for WEBDEV sites.

This property is only available for managing the images found in the Rating controls.

This property is now available for WEBDEV sites.

This property is only available for managing the images found in the Rating controls.

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 used>.ImageState

<Current number of drawings>: Integer

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

<Control used>: Control name

Name of the control to be used.

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

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

<Control used>: Control name

Name of the control to be used.

<Number of Drawings>: Integer

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

Remarks

The ImageState property applies only to:

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

The ImageState property applies only to buttons.