2.253 .picture[enum]

This attribute can be used to define different images that are displayed in the object depending on its style, activation state and situation.

Definition

  • Data type

    object [ tile ]

  • Access

    get, set

  • changed event

    yes

Index Range

tile_default

tile resource that is displayed in the normal state of the object.

tile_active

tile resource that is displayed when the object is activated.

tile_insensitive (image only)

tile resource that is displayed when the object is not operable (insensitive).

tile_mouse_over (image only)

tile resource that is displayed when the mouse pointer is over the object and the left mouse button is not pressed and the object is not activated.

The attribute .mouseover has to be true for this picture to be displayed.

tile_active_mouse_over (image only)

tile resource that is displayed when the mouse pointer is over the object and the left mouse button is pressed or the object is activated.

The attribute .mouseover has to be true for this picture to be displayed.

image

For the image object, the .picture[enum] attribute specifies the pictures (tile resources) that are displayed in different situations. The picture to be displayed depends on several factors that are described in the table below.

Apart from the exceptions listed in the table, no other picture is displayed if the picture for a certain state is missing. Therefore, all required pictures (tile resources) need to be defined.

Index

To Be Displayed

Required

tile_default

In normal state, when none of the following situations applies.

Always.

tile_active

With .style = checkbox, if

  • the image object is active.
  • the image object is not active and the left mouse button is pressed over the object.

With .style = pushbutton, if the left mouse button is pressed over the object.

Exception: In this case tile_default is displayed if tile_active is not set.

With .style = menubox temporary and independent of .mouseover, if the context menu is open and the image object is not the actual menu object.

tile_active will not be displayed if .mouseover = true and the mouse pointer is over the image object.

In the styles checkbox and menubox.

tile_insensitive

If the image object is insensitive (.real_sensitive = false).

Exception: If tile_insensitive is not set, then tile_default or tile_active (with .style = checkbox and activated checkbox) will be displayed.

Optional in all styles.

tile_mouse_over

If .mouseover = true and the mouse pointer is over the image object and

  • the left mouse button is not pressed.
  • with .style = checkbox the checkbox is not activated.

With .style = menubox independent of .mouseover, if the context menu is closed and the image object is the actual menu object.

In this state, the border is highlighted.

With .style = menubox.

Otherwise only if .mouseover = true.

tile_active_mouse_over

If .mouseover = true and the mouse pointer is over the image object and

  • the left mouse button is pressed.
  • with .style = checkbox the checkbox is activated.

With .style = menubox independent of .mouseover, if the context menu is open and the image object is the actual menu object.

With .style = menubox.

With .style = checkbox if .mouseover = true.

See also

Attributes .mouseover, .picture

menuitem

The attribute .picture[enum] of the menuitem can contain different pictures, which are displayed as symbols at a menu entry depending on its .style attribute and activation state. The attribute is indexed with an enumeration type, tile_default and tile_active are permitted as index values.

If the menuitem has the radiobutton or checkbox style, the picture from tile_active is displayed when the radiobutton or checkbox is activated. If they are not activated, the picture from tile_default is displayed. The IDM automatically switches between both pictures.

With a usual menu entry – i.e. with .style = pushbutton – always the picture from tile_default is displayed.

See also

Attribute .style