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)