xtcancelconvertselectionproc(2) [hpux man page]
XtCancelConvertSelectionProc() XtCancelConvertSelectionProc() Name XtCancelConvertSelectionProc - interface definition for procedure to cancel incremental selection transfer. Synopsis typedef void (*XtCancelConvertSelectionProc)(Widget, Atom*, Atom*, XtRequestId*, XtPointer); Widget w; Atom *selection; Atom *target; XtRequestId *request_id; XtPointer client_data; Inputs w Specifies the widget that owns the selection. selection Specifies the atom that names the selection being transferred. target Specifies the target type to which the conversion was done. request_id Specifies an opaque identification for a specific request. client_data Specifies the value passed in by the widget when it took ownership of the selection. Availability Release 4 and later. Description This procedure is registered in a call to XtOwnSelectionIncremental(), and is called by the Intrinsics to abort an incremental transfer when (as determined by the selection timeout or other mechanism) any remaining segments of the selection no longer need to be transferred. Upon receiving this callback, the selection request is considered complete and the owner should free the memory and any other resources that have been allocated for the transfer. The w, selection, and client_data arguments are those passed in the call to XtOwnSelectionIncremental(). The target and request_id argu- ments are the selection target type specified by the selection requestor, and the unique ID assigned to this transfer by the Intrinsics. Both will have been passed to a previous call to the XtConvertSelectionIncrProc also registered with XtOwnSelectionIncremental(). See Also XtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1), XtGetSelectionTimeout(1), XtOwnSelectionIncremental(1), XtSetSelec- tionTimeout(1), XtConvertSelectionIncrProc(2), XtLoseSelectionIncrProc(2), XtSelectionDoneIncrProc(2). Xt - Selections XtCancelConvertSelectionProc()
Check Out this Related Man Page
XtSelectionDoneIncrProc() XtSelectionDoneIncrProc() Name XtSelectionDoneIncrProc - interface definition for procedure called when an incremental selection transfer completes. Synopsis typedef void (*XtSelectionDoneIncrProc)(Widget, Atom *, Atom *, XtRequestId *, XtPointer); Widget w; Atom *selection; Atom *target; XtRequestId *request_id; XtPointer client_data; Inputs w Specifies the widget that owns the selection. selection Specifies the atom that names the selection being transferred. target Specifies the target type to which the conversion was done. request_id Identifies the specific conversion request that completed. client_data Specifies data registered with this procedure when the widget took ownership of the selection. Availability Release 4 and later. Description An XtSelectionDoneIncrProc is optionally registered in a call to XtOwnSelectionIncremental(), and is called by the Intrinsics after the requestor has retrieved the final (zero-length) segment of the incremental transfer to indicate that the entire transfer is complete. The w, selection, and client_data arguments are those passed to XtOwnSelectionIncremental(). The target and request_id arguments are those that were passed to the XtConvertSelectionIncrProc registered with this procedure. An XtSelectionDoneIncrProc should free any memory that was allocated for the transfer of the selection value. If no procedure is speci- fied, the Intrinsics will automatically free (using XtFree()) the last value returned by the XtConvertSelectionIncrProc. If a single buf- fer is used to transfer all the chunks of the selection, this automatic freeing by the Intrinsics should be sufficient. If separate buf- fers are used or other memory or resources are allocated to transfer the selection value, an XtSelectionDoneIncrProc should be provided to free them. Usage It is usually more convenient to use the Intrinsics atomic selection transfer mechanism which transfers the selection value in a single chunk. See XtOwnSelection(1) and XtSelectionDoneProc for more information. See Also XtGetSelectionValueIncremental(1), XtGetSelectionValuesIncremental(1), XtOwnSelection(1), XtOwnSelectionIncremental(1), XtCancelConvertSelectionProc(2), XtConvertSelectionIncrProc(2), XtLoseSelectionIncrProc(2), XtSelectionDoneProc(2). Xt - Selections XtSelectionDoneIncrProc()