NAME

       XmSeparator — The Separator widget class "XmSeparator" "widget class" "Separator"

SYNOPSIS

       #include <Xm/Separator.h>

DESCRIPTION

       Separator  is a primitive widget that separates items in a display. Several different line
       drawing styles are provided, as well as horizontal or vertical orientation.

       The Separator line drawing is automatically centered within the height of the widget for a
       horizontal  orientation  and  centered  within  the  width  of  the  widget 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.

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

       Separator   does   not   highlight  and  allows  no  traversing.  The  primitive  resource
       XmNtraversalOn is forced to False.

       The XmNseparatorType of XmNO_LINE provides an escape to  the  application  programmer  who
       needs  a different style of drawing.  A pixmap the height of the widget can be created and
       used as the background pixmap by building an argument list using  the  XmNbackgroundPixmap
       argument  type  as  defined  by  Core.   Whenever the widget is redrawn, its background is
       displayed containing the desired separator drawing.   Separator  holds  the  XmQTmenuSavvy
       trait.

   Classes
       Separator inherits behavior, resources, and traits from Core and XmPrimitive.

       The class pointer is xmSeparatorWidgetClass.

       The class name is XmSeparator.

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

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

RELATED

       Core(3), XmCreateSeparator(3), XmVaCreateSeparator(3), and XmVaCreateManagedSeparator(3).

                                                                                   XmSeparator(3)