2.157 .icon
.icon assigns an icon to an object.
-
Data type
object [ tile ] (window)
enum (messagebox)
-
Access
get, set
-
changed event
yes

-
C
Data type: DT_tile (window)
Data type: DT_enum (messagebox)
-
COBOL
Data type: DT-tile (window)
Data type: DT-enum (messagebox)
-
Classification
object-specific attribute
-
Objects
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.
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 |
|
||
icon_error |
stop sign |
error sign (crossed out circle) |
lowercase |
icon_exclamation |
exclamation mark |
||
icon_hand |
|
||
icon_information |
lowercase |
lowercase |
|
icon_query |
|
||
icon_question |
question mark |
question mark |
question mark |
icon_warning |
|
||
noicon |
|