xcb_configure_window(3)

1xcb_configure_window(3)          XCB Requests          xcb_configure_window(3)
2
3
4

NAME

6       xcb_configure_window - Configures window attributes
7

SYNOPSIS

9       #include <xcb/xproto.h>
10
11   Request function
12       xcb_void_cookie_t xcb_configure_window(xcb_connection_t *conn,
13              xcb_window_t window, uint16_t value_mask, const
14              void *value_list);
15

REQUEST ARGUMENTS

17       conn      The XCB connection to X11.
18
19       window    The window to configure.
20
21       value_mask
22                 Bitmask of attributes to change.
23
24       value_list
25                 New values, corresponding to the attributes in value_mask.
26                 The order has to correspond to the order of possible val‐
27                 ue_mask bits. See the example.
28

DESCRIPTION

30       Configures a window's size, position, border width and stacking order.
31

RETURN VALUE

33       Returns an xcb_void_cookie_t. Errors (if any) have to be handled in the
34       event loop.
35
36       If you want to handle errors directly with xcb_request_check instead,
37       use xcb_configure_window_checked. See xcb-requests(3) for details.
38

ERRORS

40       xcb_match_error_t
41                 You specified a Sibling without also specifying StackMode or
42                 the window is not actually a Sibling.
43
44       xcb_value_error_t
45                 TODO: reasons?
46
47       xcb_window_error_t
48                 The specified window does not exist. TODO: any other reason?
49

EXAMPLE

51       /*
52        * Configures the given window to the left upper corner
53        * with a size of 1024x768 pixels.
54        *
55        */
56       void my_example(xcb_connection_t *c, xcb_window_t window) {
57           uint16_t mask = 0;
58
59           mask |= XCB_CONFIG_WINDOW_X;
60           mask |= XCB_CONFIG_WINDOW_Y;
61           mask |= XCB_CONFIG_WINDOW_WIDTH;
62           mask |= XCB_CONFIG_WINDOW_HEIGHT;
63
64           const uint32_t values[] = {
65               0,    /* x */
66               0,    /* y */
67               1024, /* width */
68               768   /* height */
69           };
70
71           xcb_configure_window(c, window, mask, values);
72           xcb_flush(c);
73       }
74

AUTHOR

80       Generated from xproto.xml. Contact xcb@lists.freedesktop.org for cor‐
81       rections and improvements.
82
83
84
85X Version 11                      libxcb 1.12          xcb_configure_window(3)