HomeHome

ClassesAnnotated - TreeFunctionsHomeStructure

QCursor Class Reference


The QCursor class provides a mouse cursor with an arbitrary shape. More...

#include <qcursor.h>

List of all member functions.

Static Public Members

Related Functions

(Note that these are not member functions.)

Detailed Description

The QCursor class provides a mouse cursor with an arbitrary shape.

This class is used for mainly two things; to create mouse cursors to be associated with widgets and to get and set the position of the mouse cursor.

Qt has a number of standard cursor shapes, but you can also make custom cursor shapes based on a QBitmap, a mask and a hotspot.

To associate a cursor with a widget, use QWidget::setCursor(). To associate a cursor with all widgets (maybe for a short period of time), use QApplication::setOverrideCursor().

To set a cursor shape use QCursor::setShape() or use the QCursor constructor which takes the shape as argument, or use one of the predefined cursors:

If you want to create a cursor with an own bitmap, use either the QCursor constructor which takes a a bitmap and a mask or the constructor which takes a pixmap as arguments.

To set or get the position of the mouse cursor use the static methods QCursor::pos() and QCursor::setPos().

See also: QWidget and GUI Design Handbook: Cursors.

Examples: cursor/cursor.cpp


Member Function Documentation

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 and 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 & ) [static]

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.


Related Functions

QDataStream & operator<< (QDataStream & s, const QCursor & c)

Writes the cursor c to the stream s.

See also: Format of the QDataStream operators

QDataStream & operator>> (QDataStream & s, QCursor & c)

Reads a cursor from the stream s and sets c to the read data.

See also: Format of the QDataStream operators


Search the documentation, FAQ, qt-interest archive and more (uses www.trolltech.com):


This file is part of the Qt toolkit, copyright © 1995-2000 Trolltech, all rights reserved.


Copyright © 2000 TrolltechTrademarks
Qt version 2.2.0-beta0