XmDropTransfer(3) Library Functions Manual XmDropTransfer(3) NAME XmDropTransfer -- The DropTransfer widget class 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 com- plete a drop transaction. Clients should not explicitly create a Drop- Transfer widget. Instead, a client initiates a transfer by calling XmDrop- TransferStart, 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 trans- ferred, XmDropTransferStart needs to be called (typically with no argu- ments, 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 de- fined 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 ca- pabilities 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 Xm- DropTransferEntryRec, 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 program- mer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a re- source by name or by class in a .Xdefaults file, remove the XmN or XmC pre- fix 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 be- tween 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). +----------------------------------------------------------------------------------------------------+ | | XmDropTransfer Resource Set | | | | Name | Class | Type | Default | Access | +---------------------+---------------------+--------------------------+--------------------+--------+ | XmNdropTransfers | XmCDropTransfers | XmDropTransferEntryRec * | NULL | CG | +---------------------+---------------------+--------------------------+--------------------+--------+ | XmNincremental | XmCIncremental | Boolean | False | CSG | +---------------------+---------------------+--------------------------+--------------------+--------+ | XmNnumDropTransfers | XmCNumDropTransfers | Cardinal | 0 | CSG | +---------------------+---------------------+--------------------------+--------------------+--------+ | XmNtransferProc | XmCTransferProc | XtSelectionCallbackProc | NULL | CSG | +---------------------+---------------------+--------------------------+--------------------+--------+ | XmNtransferStatus | XmCTransferStatus | unsigned char | XmTRANSFER_SUCCESS | CSG | +---------------------+---------------------+--------------------------+--------------------+--------+ +---------------------+---------------------+--------------------------+--------------------+--------+ XmNdropTransfers Specifies the address of an array of drop transfer entry records. The drop transfer is complete when all the entries in the list have been processed. XmNincremental Specifies a Boolean value that indicates whether the transfer on the receiver side uses the Xt incremental selection transfer mechanism described in X Toolkit Intrinsics--C Language Inter- face. If the value is True, the receiver uses incremental trans- fer; if the value is False, the receiver uses atomic transfer. XmNnumDropTransfers Specifies the number of entries in XmNdropTransfers. If this re- source is set to 0 at any time, the transfer is considered com- plete. The value of XmNtransferStatus determines the completion handshaking process. XmNtransferProc Specifies a procedure of type XtSelectionCallbackProc that deliv- ers the requested selection values. The widget argument passed to this procedure is the DropTransfer widget. The selection atom passed is _MOTIF_DROP. For additional information on selection callback procedures, see X Toolkit Intrinsics--C Language Inter- face. XmNtransferStatus Specifies the current status of the drop transfer. The client up- dates this value when the transfer ends and communicates the value to the initiator. The possible values are XmTRANSFER_SUCCESS The transfer succeeded. XmTRANSFER_FAILURE The transfer failed. Inherited Resources DropTransfer inherits behavior and a resource from Object. For a complete description of this resource, refer to the Object reference page. +----------------------------------------------------------------------+ | | Object Resource Set | | | | Name | Class | Type | Default | Access | +--------------------+-------------+----------------+---------+--------+ | XmNdestroyCallback | XmCCallback | XtCallbackList | NULL | C | +--------------------+-------------+----------------+---------+--------+ +--------------------+-------------+----------------+---------+--------+ RELATED INFORMATION Object(3), XmDisplay(3), XmDragContext(3), XmDragIcon(3), XmDropSite(3), XmDropTransferAdd(3), and XmDropTransferStart(3). XmDropTransfer(3)
NAME | SYNOPSIS | DESCRIPTION | RELATED INFORMATION
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmDropTransfer&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>