
SEL_DATA
Used to initiate a blocking selection request. The arguments to this attribute are a pointer to a long
which will be set to the number of elements in the returned buffer and a pointer to an integer which
will be set to the data format. xv_get() returns a pointer to the selection data. Clients should free
the returned buffer. If the requestor client has not registered a reply_proc() with the selection
package and is requesting for MULTIPLE or INCR, the call will return with length set to SEL_ERROR
and format set to zero. If the requestor client has registered a reply_proc() with the selection
package and requesting for MULTIPLE or
INCR, the package will call the client’s
reply_proc() with the converted data. xv_get() returns after the transaction has completed
with length set to
XV_OK and format set to the returned data format. If the request fails the xv_get()
will return with length set to SEL_ERROR and format set to zero. For a
Selection_item object, this attribute specifies a pointer to the selection data.
Argument: Xv_opaque
Default: N/A
Procs: get for Selection_requestor objects
get and set for Selection_item objects
Objects: Selection_requestor, Selection_item
Usage:
data = (char *) xv_get(sel_requestor, SEL_DATA,
&length, &format);
See Also: 18.3.1, 18.2.3.4
SEL_DONE_PROC
Specifies the procedure that is called after the requestor has received the selection or
NULL if the own-
er is not ...