XmeGetTextualDragIcon(3X) UNIX System V XmeGetTextualDragIcon(3X)
NAME
XmeGetTextualDragIcon - Returns an icon widget symbolizing a
textual drag operation in progress
SYNOPSIS
#include <Xm/DragIconP.h>
Widget XmeGetTextualDragIcon(
Widget widget);
VERSION
This page documents Motif 2.1.
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).
Page 1 (printed 7/20/06)