xcb_ungrab_pointer(3)

πŸ“¦
version 1.17.0 Β· 4 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ xcb_ungrab_pointer(3) ✨

okay bestie, sit down, hydrate, and let me tell you about xcb_ungrab_pointer from the XCB Requests fam πŸ’– this is the one that hands the pointer back to the universe.


🌸 NAME 🌸

xcb_ungrab_pointer β€” release the pointer 🫢


πŸŽ€ SYNOPSIS πŸŽ€

#include <xcb/xproto.h>

πŸ’« Request function

xcb_void_cookie_t xcb_ungrab_pointer(xcb_connection_t *conn,
       xcb_timestamp_t time);

πŸ¦‹ REQUEST ARGUMENTS πŸ¦‹

  • conn β€” bestie this is just your XCB connection to X11. the line to the server. the situationship. πŸ’œ
  • time β€” a timestamp, and it's here to avoid race conditions when you're running X over the network. no cap, this one matters:

the pointer will not be released if time is earlier than the last-pointer-grab time, or later than the current X server time. it's giving "goldilocks zone" fr fr 😭


🌈 DESCRIPTION 🌈

This releases the pointer and any queued events β€” but only if you actively grabbed the pointer before, using xcb_grab_pointer, xcb_grab_button, or within a normal button press. iykyk. πŸ‘‘

EnterNotify and LeaveNotify events are generated. yes queen, the events are eventing. ✨


πŸ’… RETURN VALUE πŸ’…

Returns an xcb_void_cookie_t. Errors (if there are any at all) have to be handled in the event loop. that's just how the cookie crumbles πŸ“

If you'd rather handle errors directly with xcb_request_check instead, use xcb_ungrab_pointer_checked. See xcb-requests(3) for the details, bestie. πŸŽ€


πŸ’€ ERRORS πŸ’€

This request does never generate any errors.

not a single one. iconic behaviour honestly. no drama, no crumbs, just peace 🧚


⭐ SEE ALSO ⭐


🫢 AUTHOR 🫢

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. πŸ’Œ


okay that's the whole page, you ate that 🍽️✨

X Version 11, from libxcb 1.17.0 β€” mwah, love u, go ungrab some pointers πŸ’–πŸ¦‹πŸŒΈ periodt.