XmeStandardTargets(3X)



     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 *countreturn);

     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:

             ⊕  BACKGROUND

             ⊕  CLASS

             ⊕  CLIENT_WINDOW

             ⊕  COLORMAP

             ⊕  FOREGROUND

             ⊕  NAME

             ⊕  TARGETS

             ⊕  TIMESTAMP

             ⊕  MOTIFRENDERTABLE

             ⊕  MOTIFENCODINGREGISTRY

          Every Motif widget that acts as the source of a data
          transfer must be able to convert all the standard targets.



     Page 1                                          (printed 1/22/99)



     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 1/22/99)

Museum