XmeStandardTargets(3X) UNIX System V XmeStandardTargets(3X)
NAME
XmeStandardTargets - A toolkit function that returns a list
of standard targets
SYNOPSIS
#include <Xm/TransferP.h>
Atom * XmeStandardTargets(
Widget widget,
int count,
int *count_return);
VERSION
This page documents Motif 2.1.
DESCRIPTION
Use XmeStandardTargets to return a list of the targets that
your widget can convert. XmeStandardTargets is usually
called from an XmNconvertCallbackprocedure or from the
convertProc trait method of an XmQTtransfer trait, typically
in response to a request to convert a selection to TARGETS.
XmeStandardTargets carves out enough dynamic memory to hold
a list of all the Atoms your widget can convert. This list
will consist of the ten standard targets plus any additional
nonstandard targets supported by your widget. Use the count
argument to specify the number of nonstandard targets
supported by your widget. Then, XmeStandardTargets seeds
the first ten entries in this list with the following ten
standard targets:
o BACKGROUND
o CLASS
o CLIENT_WINDOW
o COLORMAP
o FOREGROUND
o NAME
o TARGETS
o TIMESTAMP
o _MOTIF_RENDER_TABLE
o _MOTIF_ENCODING_REGISTRY
Every Motif widget that acts as the source of a data
transfer must be able to convert all the standard targets.
Page 1 (printed 7/20/06)
XmeStandardTargets(3X) UNIX System V XmeStandardTargets(3X)
(See XmeStandardConvert(3) for details.)
After XmeStandardTargets returns, the conversion routine is
responsible for adding the count additional items to the end
of the returned list, beginning with the count_return
element.
widget Specifies the reference widget for the conversion.
count Specifies the number of additional targets, beyond
the standard targets, that the widget supports.
count_return
Returns the number of standard targets at the
front of the returned list of targets.
RETURN
This routine returns a list of Atoms. The routine puts
standard targets at the front of the list, and the list
contains an additional count atoms at the end that are
allocated but not filled in.
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),
XmeSecondarySource(3), XmeSecondaryTransfer(3),
XmeStandardConvert(3), and XmeTransferAddDoneProc(3).
Page 2 (printed 7/20/06)