XDefineCursor(3) XLIB FUNCTIONS XDefineCursor(3)

# [NAME](#NAME)

XDefineCursor, XUndefineCursor - define cursors

# [SYNTAX](#SYNTAX)

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

int XUndefineCursor(Display \**display*, Window *w*);

# [ARGUMENTS](#ARGUMENTS)

[*cursor*](#cursor)

Specifies the cursor that is to be displayed or **None**.

[*display*](#display)

Specifies the connection to the X server.

[*w*](#w)

Specifies the window.

# [DESCRIPTION](#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**.

**XDefineCursor** can generate **BadCursor** and **BadWindow** errors.

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.

**XUndefineCursor** can generate a **BadWindow** error.

# [DIAGNOSTICS](#DIAGNOSTICS)

[**BadAlloc**](#BadAlloc)

The server failed to allocate the requested resource or server memory.

[**BadCursor**](#BadCursor)

A value for a Cursor argument does not name a defined Cursor.

[**BadWindow**](#BadWindow)

A value for a Window argument does not name a defined Window.

# [SEE ALSO](#SEE_ALSO)

[**XCreateFontCursor**(3)](/man/os/libx11/XCreateFontCursor.3), [**XRecolorCursor**(3)](/man/os/libx11/XRecolorCursor.3)  
*Xlib - C Language X Interface*

libX11 1.8.14 X Version 11

---

Document: XUndefineCursor(3) from libx11 1.8.14-r3 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libx11.git