XmeDropSink(3X) UNIX System V XmeDropSink(3X)
NAME
XmeDropSink - A toolkit function that establishes a widget
as a drop site
SYNOPSIS
#include <Xm/TransferP.h>
void XmeDropSink(
Widget widget,
ArgList args,
Cardinal arg_count);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmeDropSink establishes a widget as a drop site for drag and
drop operations. This routine calls XmDropSiteRegister with
the widget specified in widget and the arguments specified
in args. It overrides any setting of XmNdropProc in args.
This routine sets the DropSite's XmNdropProc to a function
that initializes an XmDestinationCallbackStruct as follows:
o Sets the selection member to _MOTIF_DROP.
o Sets the operation member to the following value:
o XmCOPY, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROP_COPY and the dropAction
member of the XmDropProcCallbackStruct is not
XmDROP_HELP.
o XmMOVE, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROP_MOVE and the dropAction
member of the XmDropProcCallbackStruct is not
XmDROP_HELP.
o XmLINK, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROP_LINK and the dropAction
member of the XmDropProcCallbackStruct is not
XmDROP_HELP.
o XmOTHER, if the operation member of the
XmDropProcCallbackStruct passed to the
XmNdropProc is XmDROP_NOOP or if the dropAction
member of the XmDropProcCallbackStruct is
XmDROP_HELP.
o Sets the destination_data member to a pointer to the
Page 1 (printed 7/20/06)
XmeDropSink(3X) UNIX System V XmeDropSink(3X)
XmDropProcCallbackStruct passed to the XmNdropProc.
o Sets the time member to the timeStamp member of the
XmDropProcCallbackStruct passed to the XmNdropProc.
XmeDropSink makes the following sequence of calls:
1. Calls the destination widget's
destinationPreHookProctrait method, if any;
destinationPreHookProcis one of the trait methods of
the XmQTtransfer trait. XmeDropSink passes the
initialized XmDestinationCallbackStruct as the
call_data argument.
2. Calls any XmNdestinationCallback procedures that the
application has attached to the destination widget.
3. Calls the destination widget's destinationProctrait
method, if any, after all transfers initiated by
XmNdestinationCallbackprocedures have finished.
However, if an XmNdestinationCallback procedure has
called XmTransferDone with a status of
XmTRANSFER_DONE_DEFAULT, XmePrimarySink does not call
the destinationProctrait method.
widget Specifies the widget that is the drop site.
args Specifies arguments to be passed to
XmDropSiteRegister.
arg_count Specifies the number of arguments in args.
RELATED
XmQTtransfer(3), XmTransferDone(3), XmTransferValue(3),
XmeClipboardSink(3), XmeClipboardSource(3),
XmeConvertMerge(3), XmeDragSource(3), XmeGetEncodingAtom(3),
XmePrimarySink(3), XmePrimarySource(3), XmeSecondarySink(3),
XmeSecondarySource(3), XmeSecondaryTransfer(3),
XmeStandardConvert(3), XmeStandardTargets(3), and
XmeTransferAddDoneProc(3).
Page 2 (printed 7/20/06)