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