The IconGadget, introduced in Motif 2.0, is a gadget which can simultaneously display a label and a pixmap image.
Its main purpose is to pictorially represent application objects, and it is usually used in conjunction with the Container widget, which lays out IconGadget children in a variety of styles.
Note that early releases of the IconGadget tend to be unstable, particularly when attempting to set colors for the gadget. Any release of Motif prior to 2.1.10 should be considered unsafe in this respect.
Note also that the Small and Large Icon Mask resources must be pixmaps which are one bit deep; that is, they must be bitmaps. X-Designer will prevent you from attempting to specify a pixmap of greater depth than this. If you attempt to assign a non-bitmap pixmap for these resources in your own code, the IconGadget becomes unstable and is likely to crash the application.
For more details of the Icon gadget, see XmIconGadget(3X) in the OSF/Motif Programmer's Reference.
See also: