NAME

       XmDragIcon — The DragIcon widget class "XmDragIcon" "widget class" "DragIcon"

SYNOPSIS

       #include <Xm/DragDrop.h>

DESCRIPTION

       A  DragIcon  is  a component of the visual used to represent the source data in a drag and
       drop transaction. During a drag operation, a real or simulated X cursor provides drag-over
       visuals  consisting  of  a  static  portion  that represents the object being dragged, and
       dynamic cues that provide visual  feedback  during  the  drag  operation.  The  visual  is
       attained   by  blending  together  various  XmDragIcons  specified  in  the  XmDragContext
       associated with the drag operation.

       The static portion of the drag-over visual is the graphic representation  that  identifies
       the  drag  source.  For example, when a user drags several items within a list, a DragIcon
       depicting  a  list  might  be  supplied  as  the  visual.  The  XmDragContext   resources,
       XmNsourceCursorIcon  or  XmNsourcePixmapIcon,  specify  a  DragIcon  to use for the static
       portion of the visual.

       A drag-over visual incorporates dynamic cues  in  order  to  provide  visual  feedback  in
       response  to  the  user's  actions. For instance, the drag-over visual might use different
       indicators to identify the type of  operation  (copy,  link,  or  move)  being  performed.
       Dynamic cues could also alert the user that a drop site is valid or invalid as the pointer
       traverses the drop site. The XmNoperationCursorIcon and  XmNstateCursorIcon  resources  of
       XmDragContext specify DragIcons for dynamic cues.

       A  drag-over  visual  typically  consists  of  a source, operation and state DragIcon. The
       XmNblendModel resource of XmDragContext offers several options that determine which  icons
       are  blended  to  produce  the  drag-over  visual. DragIcon resources control the relative
       position of the operation and state icons (if used).  If  a  particular  DragIcon  is  not
       specified, the toolkit uses the XmScreen default DragIcons.

       An  application  initializes  a  DragIcon  with  the  function XmCreateDragIcon or through
       entries in the resource database. If a pixmap and its mask (optional) are specified in the
       resource  database,  the  toolkit  converts  the  values in the X11 Bitmap file format and
       assigns values to the corresponding resources.

   Classes
       DragIcon inherits behavior and a resource from Object.

       The class pointer is xmDragIconObjectClass.

       The class name is XmDragIcon.

   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 INFORMATION

       Object(3),    XmCreateDragIcon(3),    XmDisplay(3),    XmDragContext(3),    XmDropSite(3),
       XmDropTransfer(3), and XmScreen(3).

                                                                                    XmDragIcon(3)