DtDndCreateSourceIcon(3)

     NAME
          DtDndCreateSourceIcon - create a drag source icon

     SYNOPSIS
          #include <Dt/Dnd.h>

          Widget DtDndCreateSourceIcon(Widget parent,
                                       Pixmap pixmap,
                                       Pixmap mask);

     DESCRIPTION
          The DtDndCreateSourceIcon() function creates a Motif drag
          icon, named sourceIcon, based on the characteristics of the
          pixmap argument.  The resulting drag icon is suitable for
          use with DtDndDragStart(3).

          The parent argument is the parent of the drag icon.
          Typically this widget is the drag source.

          The pixmap argument is the pixmap representation of the data
          to be dragged.

          The mask argument is the mask for the pixmap.

          When it calls XmCreateDragIcon(3X), the
          DtDndCreateSourceIcon() function sets Motif resources in the
          drag icon; the application must not modify the values of any
          of these resources:

               XmNwidth
               XmNheight
               XmNpixmap
               XmNmask
               XmNdepth

     RETURN VALUE
          Upon successful completion, the DtDndCreateSourceIcon()
          function returns a drag icon created by calling
          XmCreateDragIcon(3X) with the characteristics of the pixmap;
          otherwise, it returns NULL.

     SEE ALSO
          DtDnd(5), DtDndDragStart(3), XmCreateDragIcon(3X),
          XmDragIcon(3X), XmDragStart(3X), XtDestroyWidget(3X).