QCursor Class Reference
^{[QtGui module]}

A Note for X11 Users

On X11, Qt supports the Xcursor library, which allows for full color icon themes. The table below shows the cursor name used for each Qt::CursorShape value. If a cursor cannot be found using the name shown below, a standard X11 cursor will be used instead. Note: X11 does not provide appropriate cursors for all possible Qt::CursorShape values. It is possible that some cursors will be taken from the Xcursor theme, while others will use an internal bitmap cursor.

Shape	Qt::CursorShape Value	Cursor Name	Shape	Qt::CursorShape Value	Cursor Name
	Qt::ArrowCursor	left_ptr		Qt::SizeVerCursor	size_ver
	Qt::UpArrowCursor	up_arrow		Qt::SizeHorCursor	size_hor
	Qt::CrossCursor	cross		Qt::SizeBDiagCursor	size_bdiag
	Qt::IBeamCursor	ibeam		Qt::SizeFDiagCursor	size_fdiag
	Qt::WaitCursor	wait		Qt::SizeAllCursor	size_all
	Qt::BusyCursor	left_ptr_watch		Qt::SplitVCursor	split_v
	Qt::ForbiddenCursor	forbidden		Qt::SplitHCursor	split_h
	Qt::PointingHandCursor	pointing_hand		Qt::OpenHandCursor	openhand
	Qt::WhatsThisCursor	whats_this		Qt::ClosedHandCursor	closedhand

See also QWidget and GUI Design Handbook: Cursors.

Member Function Documentation

QCursor::QCursor ()

Constructs a cursor with the default arrow shape.

QCursor::QCursor ( Qt::CursorShape shape )

Constructs a cursor with the specified shape.

See Qt::CursorShape for a list of shapes.

See also setShape().

QCursor::QCursor ( const QBitmap & bitmap, const QBitmap & mask, int hotX = -1, int hotY = -1 )

Constructs a custom bitmap cursor.

bitmap and mask make up the bitmap. hotX and hotY define the cursor's hot spot.

If hotX is negative, it is set to the bitmap().width()/2. If hotY is negative, it is set to the bitmap().height()/2.

The cursor bitmap (B) and mask (M) bits are combined like this:

• B=1 and M=1 gives black.
• B=0 and M=1 gives white.
• B=0 and M=0 gives transparent.
• B=1 and M=0 gives an XOR'd result.

Use the global Qt color Qt::color0 to draw 0-pixels and Qt::color1 to draw 1-pixels in the bitmaps.

Valid cursor sizes depend on the display hardware (or the underlying window system). We recommend using 32 x 32 cursors, because this size is supported on all platforms. Some platforms also support 16 x 16, 48 x 48, and 64 x 64 cursors.

See also QBitmap::QBitmap() and QBitmap::setMask().

QCursor::QCursor ( const QPixmap & pixmap, int hotX = -1, int hotY = -1 )

Constructs a custom pixmap cursor.

pixmap is the image. It is usual to give it a mask (set using QPixmap::setMask()). hotX and hotY define the cursor's hot spot.

If hotX is negative, it is set to the pixmap().width()/2. If hotY is negative, it is set to the pixmap().height()/2.

Valid cursor sizes depend on the display hardware (or the underlying window system). We recommend using 32 x 32 cursors, because this size is supported on all platforms. Some platforms also support 16 x 16, 48 x 48, and 64 x 64 cursors.

See also QPixmap::QPixmap() and QPixmap::setMask().

QCursor::QCursor ( const QCursor & c )

Constructs a copy of the cursor c.

QCursor::QCursor ( HCURSOR cursor )

Constructs a Qt cursor from the given Windows cursor.

Warning: This function is only available on Windows.

See also handle().

QCursor::QCursor ( Qt::HANDLE handle )

Constructs a Qt cursor from the given handle.

Warning: This function is only available on X11.

See also handle().

QCursor::~QCursor ()

Destroys the cursor.

const QBitmap * QCursor::bitmap () const

Returns the cursor bitmap, or 0 if it is one of the standard cursors.

HCURSOR_or_HANDLE QCursor::handle () const

Returns a platform-specific cursor handle. The HCURSOR_or_HANDLE type is HCURSOR on Windows and Qt::HANDLE on X11 and Mac OS X. On Qtopia Core it is an integer.

Warning: Using the value returned by this function is not portable.

QPoint QCursor::hotSpot () const

Returns the cursor hot spot, or (0, 0) if it is one of the standard cursors.

const QBitmap * QCursor::mask () const

Returns the cursor bitmap mask, or 0 if it is one of the standard cursors.

QPixmap QCursor::pixmap () const

Returns the cursor pixmap. This is only valid if the cursor is a pixmap cursor.

QPoint QCursor::pos ()   [static]

Returns the position of the cursor (hot spot) in global screen coordinates.

You can call QWidget::mapFromGlobal() to translate it to widget coordinates.

See also setPos(), QWidget::mapFromGlobal(), and QWidget::mapToGlobal().

void QCursor::setPos ( int x, int y )   [static]

Moves the cursor (hot spot) to the global screen position (x, y).

You can call QWidget::mapToGlobal() to translate widget coordinates to global screen coordinates.

See also pos(), QWidget::mapFromGlobal(), and QWidget::mapToGlobal().

void QCursor::setPos ( const QPoint & p )   [static]

This is an overloaded member function, provided for convenience.

Moves the cursor (hot spot) to the global screen position at point p.

void QCursor::setShape ( Qt::CursorShape shape )

Sets the cursor to the shape identified by shape.

See Qt::CursorShape for the list of cursor shapes.

See also shape().

Qt::CursorShape QCursor::shape () const

Returns the cursor shape identifier. The return value is one of the Qt::CursorShape enum values (cast to an int).

See also setShape().

QCursor::operator QVariant () const

Returns the cursor as a QVariant.

QCursor & QCursor::operator= ( const QCursor & c )

Assigns c to this cursor and returns a reference to this cursor.

Related Non-Members

QDataStream & operator<< ( QDataStream & stream, const QCursor & cursor )

This is an overloaded member function, provided for convenience.

Writes the cursor to the stream.

See also Format of the QDataStream operators.

QDataStream & operator>> ( QDataStream & stream, QCursor & cursor )

This is an overloaded member function, provided for convenience.

Reads the cursor from the stream.

See also Format of the QDataStream operators.