XmSeparatorGadget(3X)

XmSeparatorGadget - The SeparatorGadget widget class

As shipped in IRIX 6.5.19. Added in IRIX 6.5.19.

     NAME
          XmSeparatorGadget - The SeparatorGadget widget class

     SYNOPSIS
          #include <Xm/SeparatoG.h>

     DESCRIPTION
          SeparatorGadget separates items in a display.  Several line
          drawing styles are provided, as well as horizontal or
          vertical orientation.

          Lines drawn within the SeparatorGadget are automatically
          centered within the height of the gadget for a horizontal
          orientation and centered within the width of the gadget for
          a vertical orientation.  An XtSetValues with a new
          XmNseparatorType resizes the widget to its minimal height
          (for horizontal orientation) or its minimal width (for
          vertical orientation) unless height or width is explicitly
          set in the XtSetValues call.

          SeparatorGadget does not draw shadows around the separator.
          The Gadget resource XmNshadowThickness is used for the
          SeparatorGadget's thickness when XmNseparatorType is
          XmSHADOW_ETCHED_IN, XmSHADOW_ETCHED_IN_DASH,
          XmSHADOW_ETCHED_OUT, or XmSHADOW_ETCHED_OUT_DASH.

          SeparatorGadget does not highlight and allows no traversing.
          The Gadget resource XmNtraversalOn is forced to False.

        Classes
          SeparatorGadget inherits behavior and resources from Object,
          RectObj, and XmGadget Classes.

          The class pointer is xmSeparatorGadgetClass.

          The class name is XmSeparatorGadget.

        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 if 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).

                              XmSeparatorGadget Resource Set
     Name               Class              Type            Default              Access
     _________________________________________________________________________________
     XmNmargin          XmCMargin          Dimension       0                    CSG
     XmNorientation     XmCOrientation     unsigned char   XmHORIZONTAL         CSG
     XmNseparatorType   XmCSeparatorType   unsigned char   XmSHADOW_ETCHED_IN   CSG


          XmNmargin
               For horizontal orientation, specifies the space on the
               left and right sides between the border of
               SeparatorGadget and the line drawn.  For vertical
               orientation, specifies the space on the top and bottom
               between the border of SeparatorGadget and the line
               drawn.

          XmNorientation
               Specifies whether SeparatorGadget is displayed
               vertically or horizontally.  This resource can have
               values of XmVERTICAL and XmHORIZONTAL.

          XmNseparatorType
               Specifies the type of line drawing to be done in the
               Separator widget.

          o    XmSINGLE_LINE - single line.

          o    XmDOUBLE_LINE - double line.

          o    XmSINGLE_DASHED_LINE - single-dashed line.

          o    XmDOUBLE_DASHED_LINE - double-dashed line.

          o    XmNO_LINE - no line.

          o    XmSHADOW_ETCHED_IN - a line whose shadows give the
               effect of a line etched into the window.  The thickness
               of the line is equal to the value of
               XmNshadowThickness.  For horizontal orientation, the
               top shadow is drawn in XmNtopShadowColor and the bottom
               shadow is drawn in XmNbottomShadowColor.  For vertical
               orientation, the left edge is drawn in
               XmNtopShadowColor and the right edge is drawn in
               XmNbottomShadowColor.

          o    XmSHADOW_ETCHED_OUT - a line whose shadows give the
               effect of an etched line coming out of the window.  The
               thickness of the line is equal to the value of
               XmNshadowThickness.  For horizontal orientation, the
               top shadow is drawn in XmNbottomShadowColor and the
               bottom shadow is drawn in XmNtopShadowColor.  For
               vertical orientation, the left edge is drawn in
               XmNbottomShadowColor and the right edge is drawn in
               XmNtopShadowColor.

          o    XmSHADOW_ETCHED_IN_DASH - identical to
               XmSHADOW_ETCHED_IN except a series of lines creates a
               dashed line.

          o    XmSHADOW_ETCHED_OUT_DASH - identical to
               XmSHADOW_ETCHED_OUT except a series of lines creates a
               dashed line.

        Inherited Resources
          SeparatorGadget inherits behavior and resources from the
          following superclasses.  For a complete description of each
          resource, refer to the man page for that superclass.

                                    XmGadget Resource Set
     Name                    Class                   Type               Default   Access
     ___________________________________________________________________________________
     XmNbottomShadowColor    XmCBottomShadowColor    Pixel              dynamic   G
     XmNhelpCallback         XmCCallback             XtCallbackList     NULL      C
     XmNhighlightColor       XmCHighlightColor       Pixel              dynamic   G
     XmNhighlightOnEnter     XmCHighlightOnEnter     Boolean            False     CSG
     XmNhighlightThickness   XmCHighlightThickness   Dimension          0         CSG
     XmNnavigationType       XmCNavigationType       XmNavigationType   XmNONE    CSG
     XmNshadowThickness      XmCShadowThickness      Dimension          2         CSG
     XmNtopShadowColor       XmCTopShadowColor       Pixel              dynamic   G
     XmNtraversalOn          XmCTraversalOn          Boolean            False     G
     XmNunitType             XmCUnitType             unsigned char      dynamic   CSG
     XmNuserData             XmCUserData             XtPointer          NULL      CSG


                             RectObj Resource Set
     Name                   Class            Type        Default   Access
     ____________________________________________________________________
     XmNancestorSensitive   XmCSensitive     Boolean     dynamic   G
     XmNborderWidth         XmCBorderWidth   Dimension   0         CSG
     XmNheight              XmCHeight        Dimension   dynamic   CSG
     XmNsensitive           XmCSensitive     Boolean     True      CSG
     XmNwidth               XmCWidth         Dimension   dynamic   CSG
     XmNx                   XmCPosition      Position    0         CSG
     XmNy                   XmCPosition      Position    0         CSG


                             Object Resource Set
     Name                 Class         Type             Default   Access
     ____________________________________________________________________
     XmNdestroyCallback   XmCCallback   XtCallbackList   NULL      C


        Behavior
          XmSeparatorGadget has no behavior.
     RELATED INFORMATION
          Object(3X), RectObject(3X), XmCreateSeparatorGadget(3X), and
          XmGadget(3X).