DtDndCreateSourceIcon(library call)									       DtDndCreateSourceIcon(library call)

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(3), the DtDndCreateSourceIcon function sets Motif resources in the drag icon; the application must not  mod-
       ify the values of any of these resources:

	  o  XmNwidth

	  o  XmNheight

	  o  XmNpixmap

	  o  XmNmask

	  o  XmNdepth

RETURN VALUE

       Upon  successful completion, the DtDndCreateSourceIcon function returns a drag icon created by calling XmCreateDragIcon(3) with the charac-
       teristics of the pixmap; otherwise, it returns NULL.

SEE ALSO

       Dt/Dnd.h - DtDnd(5), DtDndDragStart(3), XmCreateDragIcon(3), XmDragIcon(3), XmDragStart(3), XtDestroyWidget(3).

													       DtDndCreateSourceIcon(library call)