XmeSecondarySink(3X) UNIX System V XmeSecondarySink(3X)
NAME
XmeSecondarySink - A toolkit function that establishes a
widget as the destination for secondary transfer
SYNOPSIS
#include <Xm/TransferP.h>
Boolean XmeSecondarySink(
Widget widget,
Time time);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmeSecondarySink establishes a widget as the destination for
secondary transfer operations. When the VendorShell
XmNkeyboardFocusPolicy is XmEXPLICIT, the destination is the
editable component that last had focus. When the
VendorShell XmNkeyboardFocusPolicy is XmPOINTER, the
destination is the editable component that last received
mouse button or keyboard input.
XmeSecondarySink establishes a widget as the destination by
taking ownership of the _MOTIF_DESTINATION selection.
XmeSecondarySink also establishes a function that is called
when the widget loses the selection. That function makes
the following sequence of calls:
1. Calls the widget's XmNconvertCallback procedures, if
any. XmeSecondarySink passes an
XmConvertCallbackStructto each of these
XmNconvertCallback procedures. XmeSecondarySink
initializes the XmConvertCallbackStructas follows:
o Sets the selection member to _MOTIF_DESTINATION
o Sets the target member to _MOTIF_LOSE_SELECTION
2. Calls the source widget's convertProc trait method.
However, if any XmNconvertCallback procedure returns
XmCONVERT_DONE or XmCONVERT_REFUSE, then
XmePrimarySource will not call convertProc.
widget Specifies the widget that is to be the
destination.
time Specifies the time of the transfer. This is
usually the timestamp from the event passed to an
action routine. You should call
XtLastTimeStampProcessed to generate the
timevalue. If you set time to CurrentTime or 0,
Page 1 (printed 7/20/06)
XmeSecondarySink(3X) UNIX System V XmeSecondarySink(3X)
UTM will automatically change the call to
XtLastTimeStampProcessed.
RETURN
This function returns False if the widget cannot take
ownership of the _MOTIF_DESTINATION selection. Otherwise,
it returns True.
RELATED
XmQTtransfer(3), XmTransferDone(3), XmTransferValue(3),
XmeClipboardSink(3), XmeClipboardSource(3),
XmeConvertMerge(3), XmeDragSource(3), XmeDropSink(3),
XmeGetEncodingAtom(3), XmePrimarySink(3),
XmePrimarySource(3), XmeSecondarySource(3),
XmeSecondaryTransfer(3), XmeStandardConvert(3),
XmeStandardTargets(3), and XmeTransferAddDoneProc(3).
Page 2 (printed 7/20/06)