Motif Widget Writer's Guide Migration Version

Motif 2.1 Widget Writer's Guide

XmeSecondarySink

A toolkit function that establishes a widget as the destination for secondary transfer

Format

#include <Xm/TransferP.h>
Boolean XmeSecondarySinkWidget
widgetTime time

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:

Calls the widget's XmNconvertCallback procedures, if any. XmeSecondarySink passes an XmConvertCallbackStruct to each of these XmNconvertCallback procedures. XmeSecondarySink initializes the XmConvertCallbackStruct as follows:

Sets the selection member to _MOTIF_DESTINATION

Sets the target member to _MOTIF_LOSE_SELECTION

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 time value. If you set time to CurrentTime or 0, 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).