XDefineCursor(3)

💖 XDefineCursor(3) — define cursors 💖

okay bestie, welcome to the XLIB FUNCTIONS manual page for XDefineCursor and XUndefineCursor, the two functions that handle your window cursor situation. It’s giving “set the vibe, or undo the vibe” and honestly? iconic. 🎀

🌸 NAME 🌸

XDefineCursor, XUndefineCursor — define cursors ✨

---

🦋 SYNTAX 🦋

int XDefineCursor(Display *display, Window w, Cursor cursor);

int XUndefineCursor(Display *display, Window w);

🍓 ARGUMENTS 🍓

• cursor — Specifies the cursor that is to be displayed or None.
• display — Specifies the connection to the X server.
• w — Specifies the window.

💅 DESCRIPTION 💅

If a cursor is set, it will be used when the pointer is in the window. If the cursor is None, it is equivalent to XUndefineCursor. no cap, that’s the whole rule 💖

XDefineCursor can generate BadCursor and BadWindow errors. so like… keep an eye on that, bestie 👀

The XUndefineCursor function undoes the effect of a previous XDefineCursor for this window. When the pointer is in the window, the parent’s cursor will now be used. On the root window, the default cursor is restored. periodt. ✨

XUndefineCursor can generate a BadWindow error.

bestie moment: XDefineCursor can throw BadCursor and BadWindow; XUndefineCursor can throw BadWindow. those are the error girlies to know about 💀

💀 DIAGNOSTICS 💀

• BadAlloc — The server failed to allocate the requested resource or server memory.
• BadCursor — A value for a Cursor argument does not name a defined Cursor.
• BadWindow — A value for a Window argument does not name a defined Window.

🫶 SEE ALSO 🫶

• XCreateFontCursor(3)
• XRecolorCursor(3)
• Xlib - C Language X Interface

---

💜 signing off from X Version 11, libX11 1.8.14 — it’s the XDefineCursor(3) page, and the footer didn’t include a date so I’m not gonna invent one, bestie. love u, bye 🧚‍♀️✨