NAME

       XmIconGadget — The IconGadget widget class "XmIconGadget" "iconGadget" "IconGadget"

SYNOPSIS

       #include <Xm/IconG.h>

DESCRIPTION

       IconGadget  is  an  instantiable  widget  used to display both text and a pixmap in various combinations.
       Other widgets that hold the XmQTcontainer trait, such as  Container,  can  use  IconGadget  to  represent
       objects.

       IconGadget  text is a compound string. If no text is supplied, then the compound string is generated from
       the gadget name. IconGadget text is placed relative to the type of associated pixmap.

       Depending upon the XmNviewType resource, IconGadget can display two views:

       XmLARGE_ICON
                 The IconGadget text string is displayed below the pixmap, and centered.

       XmSMALL_ICON
                 The IconGadget text string  is  placed  on  the  side  of  the  small  icon,  in  the  widget's
                 XmNlayoutDirection.

       A  bitmap mask can be supplied for each pixmap to clip the pixmap into some shape other than a rectangle.
       The  XmNlargeIconMask  and  XmNsmallIconMask  resources  specify  the  large  and  small   bitmap   masks
       respectively.  Visual  emphasis  for  the  IconGadget  is  provided  with the XmNvisualEmphasis resource.
       IconGadget's XmNdetail and XmNdetailCount resources provide a detail view for IconGadgets,  enabling  the
       display  of  Strings  alongside  the  IconGadget. The exact layout ordering of the strings depends on the
       associated containing widget.

       IconGadget uses the XmQTcontainer and XmQTspecifyRenderTable traits, and holds  the  XmQTcareParentVisual
       and XmQTcontainerItem traits.

   Classes
       IconGadget inherits behaviour, resources, and traits from Object, RectObject, and XmGadget classes.

       The class pointer is xmIconGadgetClass.

       The class name is XmIconGadget.

   New Resources
       The  following  table  defines  a  set  of  widget  resources used by the programmer to specify data. The
       programmer can also set the resource values for the inherited classes to set attributes for this  widget.
       To  reference  a  resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use
       the remaining letters.  To specify one of the defined values for a resource in a .Xdefaults file,  remove
       the  Xm  prefix  and  use  the  remaining  letters  (in  either  lowercase  or uppercase, but include any
       underscores between words). The codes in the access column indicate whether the given resource can be set
       at  creation  time  (C),  set  by  using  XtSetValues  (S), retrieved by using XtGetValues (G), or is not
       applicable (N/A).

       ┌───────────────────────────────────────────────────────────────────────────────────────┐
--

RELATED

       Core(3),    XmContainer(3),    XmCreateIconGadget(3),    XmGadget(3),    XmVaCreateIconGadget(3),     and
       XmVaCreateManagedIconGadget(3).

                                                                                                 XmIconGadget(3)