[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Widget Writer's Guide


XmeGetTextualDragIcon

Returns an icon widget symbolizing a textual drag operation in progress

Format

#include <Xm/DragIconP.h>
Widget XmeGetTextualDragIconWidget
widget

DESCRIPTION

The Motif Style Guide requires an application to display a drag icon to symbolize a drag operation in progress. Each drag icon consists of a source icon, a state icon, and an operation icon. The source icon symbolizes the object being dragged. If the object being dragged is text, the standard Motif text source icon should be displayed. To get the standard Motif text source icon, call XmeGetTextualDragIcon. For more information about drag icons, see the Motif Programmer's Guide.

The XmeGetTextualDragIcon function returns the standard text source icon widget. Typically, you assign this returned widget as the value of the XmNsourceCursorIcon resource of the XmDragContext widget; for example:



drag_icon = XmeGetTextualDragIcon(w);
XtSetArg(args[n], XmNsourceCursorIcon, drag_icon), n++;
(void) XmeDragSource(w, event, args, n);

widget
Specifies any widget displayed on the screen on which you want the source icon to appear.

RETURN

Returns a text source icon widget. The returned icon depends on the value of the XmNenableDragIcon resource of XmScreen.

RELATED

XmDragStart(3), XmDragContext(3), and XmScreen(3).


[ Previous | Next | Contents | Glossary | Home | Search ]