XmePrimarySource(3X) UNIX System V XmePrimarySource(3X)
NAME
XmePrimarySource - A toolkit function that takes ownership
of the primary selection
SYNOPSIS
#include <Xm/TransferP.h>
Boolean XmePrimarySource(
Widget widget,
Time time);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmePrimarySource takes ownership of the primary selection.
This routine establishes a function that is called when the
widget is asked to convert the primary selection. That
function makes the following sequence of calls:
1. Calls the application's XmNconvertCallback procedures,
if any. XmePrimarySource passes an
XmConvertCallbackStruct(with the selection member set
to PRIMARY) 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 XmePrimarySource will not call convertProc.
XmePrimarySource 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. XmePrimarySource passes an
XmConvertCallbackStructto each of these
XmNconvertCallback procedures. XmePrimarySource
initializes the XmConvertCallbackStructas follows:
o Sets the selection member to PRIMARY
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 take ownership of
Page 1 (printed 7/20/06)
XmePrimarySource(3X) UNIX System V XmePrimarySource(3X)
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 primary 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),
XmeSecondarySink(3), XmeSecondarySource(3),
XmeSecondaryTransfer(3), XmeStandardConvert(3),
XmeStandardTargets(3), and XmeTransferAddDoneProc(3).
Page 2 (printed 7/20/06)
