XmeSecondarySource(3X) UNIX System V XmeSecondarySource(3X)
NAME
XmeSecondarySource - A toolkit function that takes ownership
of the secondary selection
SYNOPSIS
#include <Xm/TransferP.h>
Boolean XmeSecondarySource(
Widget widget,
Time time);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmeSecondarySource takes ownership of the secondary
selection. A widget usually calls XmeSecondarySource from
an action routine that starts a secondary selection.
XmeSecondarySource establishes a function that is called
when the widget is asked to convert the secondary selection.
That function makes the following sequence of calls:
1. Calls the application's XmNconvertCallback procedures,
if any. XmeSecondarySource passes an
XmConvertCallbackStruct(with the selection member set
to SECONDARY) to each of these XmNconvertCallback
procedures.
2. Calls the source widget's convertProc trait method;
convertProc is one of the trait methods of the
XmQTtransfertrait. However, if any XmNconvertCallback
procedure returns XmCONVERT_DONE or XmCONVERT_REFUSE,
then XmeSecondarySource will not call convertProc.
XmeSecondarySource also establishes a function that is
called when the widget loses the selection. That function
makes the following sequence of calls:
1. Calls the application's XmNconvertCallback procedures,
if any. XmeSecondarySource passes an
XmConvertCallbackStructto each of these
XmNconvertCallback procedures. XmeSecondarySource
initializes the XmConvertCallbackStructas follows:
o Sets the selection member to SECONDARY
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
XmeSecondarySource will not call convertProc.
Page 1 (printed 7/20/06)
XmeSecondarySource(3X) UNIX System V XmeSecondarySource(3X)XmeSecondarySource is used in conjunction with
XmeSecondaryTransfer.
widget Specifies the widget that is to take ownership of
the selection.
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,
UTM will automatically change the call to
XtLastTimeStampProcessed.
RETURN
This function returns False if the widget cannot take
ownership of the secondary 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), XmeSecondarySink(3),
XmeSecondaryTransfer(3), XmeStandardConvert(3),
XmeStandardTargets(3), and XmeTransferAddDoneProc(3).
Page 2 (printed 7/20/06)
