2.157 .icon

.icon assigns an icon to an object.

  • Data type

    object [ tile ] (window)

    enum (messagebox)

  • Access

    get, set

  • changed event

    yes

window

For the window object, .icon is used to assign a tile resource that will appear as symbol in the title bar of the window. If .icon is not set, the IDM uses the graphic resources IDM_AppIcon or IDM_DefIcon, which are predefined in the IDM libraries.

The resources IDM_AppIcon and IDM_DefIcon are provided by the IDM for the icon in the title bar of windows and, on Microsoft Windows, also as application icon. This icon can be changed by defining a custom graphic resource with the identifier IDM_AppIcon in the application. The IDM_DefIcon provided by IDM is used if no IDM_AppIcon is available. This depends among other things on how the application is linked. Information on defining and linking graphic resources can be found in the developer documentation of the system.

The attribute is not supported by the IDM for Motif.

messagebox

For amessagebox the .icon attribute has the data type enum.

Value range

icon_asterisk

Displays the window system specific information icon.

icon_error

Displays the window system specific error icon.

icon_exclamation

Displays the window system specific warning icon.

icon_hand

Displays the window system specific error icon.

icon_information

Displays the window system specific information icon.

icon_query

Displays the window system specific question icon.

icon_question

Displays the window system specific question icon.

icon_warning

Displays the window system specific warning icon.

noicon

Does not display an icon.

The representation of .icon depends on the window system, its version and – on Qt – the UI style. There may also be multiple assignment.

Value

Windows

Motif

Qt

icon_asterisk

like icon_information

icon_error

stop sign

error sign (crossed out circle)

lowercase x

icon_exclamation

exclamation mark !

icon_hand

like icon_error

icon_information

lowercase i in a circle

lowercase i

icon_query

like icon_question

icon_question

question mark ?

question mark ? (in a head)

question mark ?

icon_warning

like icon_exclamation

noicon

none