Класс QCursor

Класс QCursor предоставляет курсор мыши с произвольной формой. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Открытые функции

Статические открытые члены

Связанные нечлены

Подробное описание

Этот класс в основном используется для создания курсоров мыши, связанных с определенными виджетами, и для получения и установки положения курсора мыши.

Qt имеет ряд стандартных форм курсора, но вы также можете создавать пользовательские формы курсора, основанные на QBitmap, маске и горячей точке.

Чтобы связать курсор с виджетом, используйте QWidget::setCursor(). Чтобы связать курсор со всеми виджетами (обычно на короткое время), используйте QGuiApplication::setOverrideCursor().

Чтобы установить форму курсора, используйте QCursor::setShape() или используйте конструктор QCursor, который принимает форму в качестве аргумента, или вы можете использовать один из предопределенных курсоров, определенных в перечислении Qt::CursorShape.

Если вы хотите создать курсор с вашим собственным битовым изображением, используйте конструктор QCursor, который принимает битовое изображение и маску в качестве аргументов, или конструктор, принимающий в качестве аргумента пиксель.

Чтобы установить или получить положение курсора мыши, используйте статические методы QCursor::pos() и QCursor::setPos().

Примечание: Возможно создать QCursor до QGuiApplication, но это бесполезно, кроме как в качестве заполнителя для реального QCursor, созданного после QGuiApplication. Попытка использовать QCursor, созданный до QGuiApplication, приведет к сбою.

Примечание для пользователей X11

В X11 Qt поддерживает библиотеку Xcursor, которая позволяет использовать полные цветные темы значков курсора. В таблице ниже показано имя курсора, используемое для каждого значения Qt::CursorShape. Если курсор не может быть найден с помощью указанного ниже имени, вместо него будет использован стандартный курсор X11. Примечание: X11 не предоставляет подходящие курсоры для всех возможных значений Qt::CursorShape. Возможно, некоторые курсоры будут взяты из темы Xcursor, а другие будут использовать внутренний курсор битового изображения.

Форма	Qt::CursorShape Значение	Имя курсора	Форма	Qt::CursorShape Значение	Имя курсора
	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
	Qt::DragMoveCursor	dnd-move или move		Qt::DragCopyCursor	dnd-copy или copy
	Qt::DragLinkCursor	dnd-link или link

См. также QWidget и Руководство по проектированию пользовательского интерфейса: Курсоры.

Документация по функциям-членам

[since 5.5] QCursor::QCursor(QCursor &&other)

Конструктор перемещения курсора из other. После перемещения из other единственные допустимые операции для other — уничтожение и (перемещение и копирование) присваивание. Результаты вызова любой другой функции-члена на переместившемся экземпляре не определены.

Эта функция была введена в Qt 5.5.

QCursor::QCursor(const QCursor &c)

Создаёт копию курсора c.

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

Создаёт пользовательский курсор из пиксельной карты.

pixmap — изображение. Обычно ему задаётся маска (используя QPixmap::setMask()). hotX и hotY определяют точку привязки курсора.

Если hotX отрицательно, он устанавливается в pixmap().width()/2. Если hotY отрицательно, он устанавливается в pixmap().height()/2.

Допустимые размеры курсора зависят от оборудования дисплея (или от используемой системы окон). Рекомендуется использовать курсоры размером 32x32, так как этот размер поддерживается на всех платформах. Некоторые платформы также поддерживают курсоры размером 16x16, 48x48 и 64x64.

См. также QPixmap::QPixmap() и QPixmap::setMask().

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

Создаёт пользовательский курсор из битовой карты.

bitmap и mask составляют битовую карту. hotX и hotY определяют точку привязки курсора.

Если hotX отрицательно, он устанавливается в bitmap().width()/2. Если hotY отрицательно, он устанавливается в bitmap().height()/2.

Биты курсовой битовой карты (B) и маски (M) комбинируются следующим образом:

• B=1 и M=1 даёт чёрный цвет.
• B=0 и M=1 даёт белый цвет.
• B=0 и M=0 даёт прозрачность.
• B=1 и M=0 даёт результат XOR под Windows, неопределённые результаты на всех остальных платформах.

Используйте глобальные цвета Qt Qt::color0 для рисования 0-пикселей и Qt::color1 для рисования 1-пикселей в битовых картах.

Допустимые размеры курсора зависят от оборудования дисплея (или от используемой системы окон). Рекомендуется использовать курсоры размером 32x32, так как этот размер поддерживается на всех платформах. Некоторые платформы также поддерживают курсоры размером 16x16, 48x48 и 64x64.

См. также QBitmap::QBitmap() и QBitmap::setMask().

QCursor::QCursor(Qt::CursorShape shape)

Создаёт курсор с заданной формой.

Список форм см. в Qt::CursorShape.

См. также setShape().

QCursor::QCursor()

Создаёт курсор с формой по умолчанию — стрелкой.

[since 5.2] QCursor &QCursor::operator=(QCursor &&other)

Перемещающее присваивание other текущему экземпляру QCursor.

Эта функция была введена в Qt 5.2.

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

Присваивает c текущему курсору и возвращает ссылку на этот курсор.

QCursor::~QCursor()

Уничтожает курсор.

QBitmap QCursor::bitmap() const

Возвращает битовую карту курсора или пустую битовую карту, если это стандартный курсор.

QPoint QCursor::hotSpot() const

Возвращает точку привязки курсора или (0, 0), если это стандартный курсор.

QBitmap QCursor::mask() const

Возвращает битовую маску курсора или пустую битовую карту, если это стандартный курсор.

QPixmap QCursor::pixmap() const

Возвращает пиксельную карту курсора. Это допустимо только если курсор является курсором из пиксельной карты.

[static] QPoint QCursor::pos()

Возвращает позицию курсора (точки привязки) на главном экране в глобальных координатах экрана.

Вы можете использовать QWidget::mapFromGlobal(), чтобы перевести её в координаты виджета.

См. также setPos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal() и QGuiApplication::primaryScreen().

[static] QPoint QCursor::pos(const QScreen *screen)

Возвращает позицию курсора (точки привязки) на экране screen в глобальных координатах экрана.

Вы можете использовать QWidget::mapFromGlobal(), чтобы перевести её в координаты виджета.

См. также setPos(), QWidget::mapFromGlobal() и QWidget::mapToGlobal().

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

Перемещает курсор (точку привязки) на главном экране в глобальную позицию экрана (x, y).

Вы можете использовать QWidget::mapToGlobal(), чтобы перевести координаты виджета в глобальные координаты экрана.

См. также pos(), QWidget::mapFromGlobal(), QWidget::mapToGlobal() и QGuiApplication::primaryScreen().

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

Перемещает курсор (точку привязки) на экране screen в глобальную позицию экрана (x, y).

Вы можете вызвать QWidget::mapToGlobal(), чтобы перевести координаты виджета в глобальные экранные координаты.

См. также pos(), QWidget::mapFromGlobal(), и QWidget::mapToGlobal().

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

Это перегруженный метод.

Перемещает курсор (горячую точку) в глобальные экранные координаты в точке p.

[static] void QCursor::setPos(QScreen *screen, const QPoint &p)

Это перегруженный метод.

Перемещает курсор (горячую точку) в глобальные экранные координаты экрана screen в точке p.

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

Устанавливает форму курсора, идентифицируемую значением shape.

См. Qt::CursorShape для списка форм курсора.

См. также shape().

Qt::CursorShape QCursor::shape() const

Возвращает идентификатор формы курсора.

См. также setShape().

[since 5.7] void QCursor::swap(QCursor &other)

Меняет местами этот курсор с курсором other.

Эта функция была добавлена в Qt 5.7.

QVariant QCursor::operator QVariant() const

Возвращает курсор как QVariant.