XUndefineCursor(3)

XUndefineCursor3

Define cursors

Part of XDefineCursor(3).

Usage

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.

Overview

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

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.

Releases

11 releases since Debian 4.0 (Etch); the text changed 10 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10
  8. 11
  9. 12
  10. 13
  11. Arch

From libx11 1.8.14-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.