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)