QCursor

QCursor is a class in the Qt GUI framework that encapsulates the mouse cursor's appearance and position. It provides a portable way to query and specify the cursor used by widgets or by the entire application. A QCursor can represent a standard system cursor via a Qt::CursorShape value, or it can wrap a custom image with a defined hotspot.

Constructors and representations include: QCursor(), QCursor(Qt::CursorShape shape), and QCursor(const QPixmap &pixmap, int hotX, int hotY). The shape-based constructor is used for common cursors (arrow, I-beam, wait, etc.), while the pixmap-based constructor creates a cursor from a bitmap with a specified hotspot.

Accessors and properties allow inspection of how the cursor is defined. The shape() method returns the current cursor shape, and pixmap() returns the underlying pixmap for custom cursors. The hotspot coordinates define the point within the pixmap that corresponds to the actual pointer location.

Position and movement are provided as static functions. pos() returns the current global cursor position as a QPoint. setPos(int x, int y) moves the cursor to the given screen coordinates, and setPos(const QPoint &pos) is also available in many Qt versions.

Usage in applications typically involves applying a cursor to widgets with QWidget::setCursor, or applying a global cursor with QGuiApplication::setOverrideCursor and restoring it with QGuiApplication::restoreOverrideCursor. QCursor interacts with the platform’s windowing system, so appearance and precise hotspot handling may vary by platform.

See also: Qt::CursorShape, QWidget::setCursor, QGuiApplication::setOverrideCursor.