[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Widget Writer's Guide


XmeStandardTargets

A toolkit function that returns a list of standard targets

Format

#include <Xm/TransferP.h>
Atom * XmeStandardTargetsWidget
widgetint countint
*count_return

DESCRIPTION

Use XmeStandardTargets to return a list of the targets that your widget can convert. XmeStandardTargets is usually called from an XmNconvertCallback procedure 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:

  1. BACKGROUND

  2. CLASS

  3. CLIENT_WINDOW

  4. COLORMAP

  5. FOREGROUND

  6. NAME

  7. TARGETS

  8. TIMESTAMP

  9. _MOTIF_RENDER_TABLE

  10. _MOTIF_ENCODING_REGISTRY

    Every Motif widget that acts as the source of a data transfer must be able to convert all the standard targets. (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).


  11. [ Previous | Next | Contents | Glossary | Home | Search ]