xcb_get_selection_owner - Man Page

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

The man pages xcb_get_selection_owner_reply(3) and xcb_get_selection_owner_unchecked(3) are aliases of xcb_get_selection_owner(3).

libxcb 1.17.0 X Version 11 XCB Requests