NAME

       XmDrawingArea — The DrawingArea widget class "XmDrawingArea" "widget class" "DrawingArea"

SYNOPSIS

       #include <Xm/DrawingA.h>

DESCRIPTION

       DrawingArea is an empty widget that is easily adaptable to a variety of purposes.  It does
       no drawing and defines no behavior except for invoking callbacks.   Callbacks  notify  the
       application when graphics need to be drawn (exposure events or widget resize) and when the
       widget receives input from the keyboard or mouse.

       Applications are responsible for defining appearance and behavior as needed in response to
       DrawingArea callbacks.

       DrawingArea  is  also  a  composite widget and subclass of XmManager that supports minimal
       geometry management for multiple widget or gadget children.

       DrawingArea uses the XmNinitialFocus resource  of  XmManager  to  define  whether  or  not
       DrawingArea  will  receive  focus  when  it  is  traversed  to, even if it has traversable
       children. If XmNinitialFocus is NULL, DrawingArea receives focus only if it does not  have
       any  traversable children. If XmNinitialFocus is not NULL, then DrawingArea receives focus
       when traversed to. In the latter case, the application first needs to be able  to  realize
       that  the  DrawingArea  will receive focus, then, as appropriate, needs to either call the
       XmProcessTraversal function for the desired child,  or  to  navigate  across  the  private
       DrawingArea graphics objects.

       The   following   resources   are   not   currently   used   by  the  DrawingArea  widget:
       XmNshadowThickness,  XmNtopShadowPixmap,  XmNbottomShadowPixmap,  XmNtopShadowColor,   and
       XmNbottomShadowColor

   Data Transfer Behavior
       DrawingArea  has  no widget class conversion or destination procedure.  Subclasses and the
       XmNconvertCallback  procedures  are  responsible  for  any   conversion   of   selections.
       Subclasses  and  the  XmNdestinationCallback  procedures  are  responsible  for  any  data
       transfers to the widget.

   Classes
       DrawingArea inherits behavior and resources from  the  Core,  Composite,  Constraint,  and
       XmManager classes.

       The class pointer is xmDrawingAreaWidgetClass.

       The class name is XmDrawingArea.

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

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

RELATED

       Composite(3),     Constraint(3),     Core(3),     XmCreateDrawingArea(3),    XmManager(3),
       XmVaCreateDrawingArea(3), and XmVaCreateManagedDrawingArea(3).

                                                                                 XmDrawingArea(3)