ICON
Dialog's icon. This icon will be used when the dialog is minimized among other places by the native system.
Value
Name of a IUP image.
Default: NULL
Notes
Icon sizes are usually less than or equal to 32x32. In Windows, an icon with 16x16, 32x32 and 48x48 images of 32 bpp covers every place the system shows it. In Windows and WinUI, when not set, the first icon resource of the executable is used.
In GTK 4 the value can also be the name of an icon in the icon theme, used when no IUP image has that name.
In macOS and Haiku the icon is the application icon, shown in the Dock and in the Deskbar; setting it on any dialog replaces it for the whole application.
In Android and iOS the icon is shown in the title bar next to the title.
On Wayland the taskbar and window switcher icon comes from the
.desktop file matched by the APPID global. In GTK 4 this attribute
is also sent through the xdg-toplevel-icon protocol when the compositor
supports it.
Use IupSetHandle or IupSetAttributeHandle to associate an image to a name.