xcb_get_selection_owner man page

xcb_get_selection_owner — Gets the owner of a selection

Synopsis

#include <xcb/xproto.h>

Request function

xcb_get_selection_owner_cookie_t xcb_get_selection_owner(xcb_connection_t *conn, xcb_atom_t selection);

Reply datastructure

typedef struct xcb_get_selection_owner_reply_t {
    uint8_t      response_type;
    uint8_t      pad0;
    uint16_t     sequence;
    uint32_t     length;
    xcb_window_t owner;
} xcb_get_selection_owner_reply_t;

Reply function

xcb_get_selection_owner_reply_t *xcb_get_selection_owner_reply(xcb_connection_t *conn, xcb_get_selection_owner_cookie_t cookie, xcb_generic_error_t **e);

Request Arguments

conn
The XCB connection to X11.
selection
The selection.

Reply Fields

response_type
The type of this reply, in this case XCB_GET_SELECTION_OWNER. This field is also present in the xcb_generic_reply_t and can be used to tell replies apart from each other.
sequence
The sequence number of the last request processed by the X11 server.
length
The length of the reply, in words (a word is 4 bytes).
owner
The current selection owner window.

Description

Gets the owner of the specified selection.

TODO: briefly explain what a selection is.

Return Value

Returns an xcb_get_selection_owner_cookie_t. Errors have to be handled when calling the reply function xcb_get_selection_owner_reply.

If you want to handle errors in the event loop instead, use xcb_get_selection_owner_unchecked. See xcb-requests(3) for details.

Errors

xcb_atom_error_t
selection does not refer to a valid atom.

See Also

xcb-requests(3), xcb_set_selection_owner(3)

Author

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.

Referenced By

xcb_get_selection_owner_reply(3) and xcb_get_selection_owner_unchecked(3) are aliases of xcb_get_selection_owner(3).

libxcb 1.12 X Version 11 XCB Requests