
B
Selection Compatibility
Procedures and Macros
This section lists the XView Selection procedures and macros in alphabetical order. If you
are creating new applications with XView Version 3, you should not use these functions
(refer to Chapter 18, Selections, in the XView Programming Manual for further information).
selection_acquire()
Acquires the selection of a specified rank. This is typically used internally by XView
packages. It is not used to inquire about the current selection.
Seln_rank
selection_acquire(server, client, asked)
Xv_Server server;
Seln_client client;
Seln_rank asked;
client is the opaque handle returned from selection_create(). The client
uses this call to become the new holder of the selection of rank asked. asked should
be one of SELN_CARET, SELN_PRIMARY, SELN_SECONDARY, SELN_SHELF, or
SELN_UNSPECIFIED. If successful, the rank actually acquired is returned.
If asked is
SELN_UNSPECIFIED, the client indicates it wants whichever of the prima-
ry or secondary selections is appropriate given the current state of the function keys;
the one acquired can be determined from the return value.
selection_ask()
selection_ask() is a simplified form of selection_request() that looks
and acts very much like seln_query(). The only difference is that it does not use a
callback proc and so cannot handle replies that require more than a single buffer (e.g.,
long text selections). If it receives a reply ...