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