NAME

       XmDropTransfer — The DropTransfer widget class "XmDropSite" "widget class" "DropTransfer"

SYNOPSIS

       #include <Xm/DragDrop.h>

DESCRIPTION

       DropTransfer  provides  a  set  of  resources  that  identifies the procedures and associated information
       required by the toolkit in order to  process  and  complete  a  drop  transaction.   Clients  should  not
       explicitly   create   a  DropTransfer  widget.   Instead,  a  client  initiates  a  transfer  by  calling
       XmDropTransferStart, which initializes and returns a DropTransfer widget.  If  this  function  is  called
       within an XmNdropProc callback, the actual transfers are initiated after the callback returns. Even if no
       data  needs  to  be  transferred, XmDropTransferStart needs to be called (typically with no arguments, or
       just setting XmNtransferStatus) to finish the drag and drop transaction.

       The XmNdropTransfers resource specifies a transfer list that describes the requested target types for the
       source data. A transfer list is an array of XmDropTransferEntryRec structures, each of which identifies a
       target type. The transfer list is analogous to the MULTIPLE selections capability defined in  the  Inter-
       Client Communication Conventions Manual (ICCCM).

       The    DropTransfer    resource,    XmNtransferProc,    specifies    a   transfer   procedure   of   type
       XtSelectionCallbackProc  that  delivers  the  requested  selection  data.  This  procedure  operates   in
       conjunction  with  the underlying Xt selection capabilities and is called for each target in the transfer
       list.  Additional  target  types  can  be  requested  after  a  transfer  is  initiated  by  calling  the
       XmDropTransferAdd function.

   Structures
       An  XmDropTransferEntry  is  a  pointer  to the following structure of type XmDropTransferEntryRec, which
       identifies a selection target associated with a given drop transaction:

       typedef struct
       {
               XtPointer       client_data;
               Atom target;
       } XmDropTransferEntryRec, *XmDropTransferEntry;

       client_data
                 Specifies any additional information required by this selection target

       target    Specifies a selection target associated with the drop operation

   Classes
       DropTransfer inherits behavior and a resource from Object.

       The class pointer is xmDropTransferObjectClass.

       The class name is XmDropTransfer.

   New Resources
       The following table defines a set of widget resources  used  by  the  programmer  to  specify  data.  The
       programmer  can also set the resource values for the inherited classes to set attributes for this widget.
       To reference a resource by name or by class in a .Xdefaults file, remove the XmN or XmC  prefix  and  use
       the  remaining  letters. To specify one of the defined values for a resource in a .Xdefaults file, remove
       the Xm prefix and use  the  remaining  letters  (in  either  lowercase  or  uppercase,  but  include  any
       underscores  between  words). The codes in the access column indicate if the given resource can be set at
       creation time (C), set by using XtSetValues (S), retrieved by using XtGetValues (G), or is not applicable
       (N/A).

       ┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
--

RELATED INFORMATION

       Object(3),  XmDisplay(3),  XmDragContext(3),  XmDragIcon(3),  XmDropSite(3),  XmDropTransferAdd(3),   and
       XmDropTransferStart(3).

                                                                                               XmDropTransfer(3)