xcb_shape_input_selected(3)

✨ xcb_shape_input_selected ✨

okay bestie, we're doing the xcb_shape_input_selected thing from XCB Requests (that's the manual, the lib is libxcb) and honestly? it's giving "short but mysterious". let's get into it 💅

---

🌸 NAME 🌸

xcb_shape_input_selected — and that's it. that's the whole name section. the description line is literally empty, no cap. the original page left it blank so we're leaving it blank, i don't make the rules 🫶

---

🦋 SYNOPSIS 🦋

first things first, you gotta bring in the header:

#include <xcb/shape.h>

💖 Request function 💖

xcb_shape_input_selected_cookie_t
       xcb_shape_input_selected(xcb_connection_t *conn,
       xcb_window_t destination_window);

🎀 Reply datastructure 🎀

here's the lil struct the reply comes back in, character for character:

typedef struct xcb_shape_input_selected_reply_t {
    uint8_t  response_type;
    uint8_t  enabled;
    uint16_t sequence;
    uint32_t length;
} xcb_shape_input_selected_reply_t;

💜 Reply function 💜

and here's how you actually go get that reply:

xcb_shape_input_selected_reply_t
       *xcb_shape_input_selected_reply(xcb_connection_t *conn,
       xcb_shape_input_selected_cookie_t cookie,
       xcb_generic_error_t **e);

---

🌈 REQUEST ARGUMENTS 🌈

• conn — your XCB connection to X11. the whole hotline to the server, basically. 📞
• destination_window — TODO: NOT YET DOCUMENTED. yeah bestie, the docs just said "not yet" and moved on. iconic of them, honestly 😭🙈

---

⭐ REPLY FIELDS ⭐

• response_type — the type of this reply, and for this one it's XCB_SHAPE_INPUT_SELECTED. plot twist: this field also lives in the xcb_generic_reply_t, so you can use it to tell your replies apart from each other when they're all stacked up in the group chat. 💀
• sequence — the sequence number of the last request the X11 server processed. the receipts, basically. 🧾
• length — how long the reply is, in words. and a word here is 4 bytes, so do the math, don't get caught slipping. 🔥
• enabled — TODO: NOT YET DOCUMENTED. again!! the docs are gatekeeping this one too. not me finding out the hard way 🙈

---

🍓 DESCRIPTION 🍓

...nothing. literally nothing. the original section is empty. the vibes are immaculate and the information is nonexistent. moving on bestie 💅✨

---

👑 RETURN VALUE 👑

so it hands you back an xcb_shape_input_selected_cookie_t. 🍪 and here's the tea: errors have to be handled when you call the reply function, xcb_shape_input_selected_reply.

but if you'd rather deal with errors in the event loop instead, use xcb_shape_input_selected_unchecked. go peek at xcb-requests(3) for the deets on how that all works. 🫶

---

💀 ERRORS 💀

this request does never generate any errors. never ever. zero. none. no drama, no errors, just vibes. ✨

---

🔥 SEE ALSO 🔥

nothing here either. the original SEE ALSO section is empty, so we're sitting in comfortable silence together. 🌸

---

💖 AUTHOR 💖

generated from shape.xml. if you need corrections or improvements, contact xcb@lists.freedesktop.org — they're the ones to text. 📧

---

and that's a wrap, bestie!! this page came from X Version 11, specifically libxcb 1.17.0, and if you ever need to find it again it's filed under xcb_shape_input_selected(3). slay, you read the whole thing, so proud of you 🎀🦋💜