Класс QHoverEvent

Класс QHoverEvent содержит параметры, описывающие событие мыши. Подробнее...

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

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

• 2 открытых функции унаследованы от QInputEvent
• 6 открытых функций унаследованы от QEvent

Защищённые переменные

Дополнительные унаследованные члены

• 1 свойство унаследовано от QEvent
• 1 статический открытый член унаследован от QEvent

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

Класс QHoverEvent содержит параметры, описывающие событие мыши.

События мыши происходят, когда указатель мыши перемещается в, из или внутри виджета, и если у виджета есть атрибут Qt::WA_Hover.

Функция pos() возвращает текущее положение курсора, а oldPos() возвращает предыдущее положение мыши.

Существует несколько сходств между событиями QEvent::HoverEnter и QEvent::HoverLeave, и событиями QEvent::Enter и QEvent::Leave. Однако они немного отличаются, поскольку в обработчике событий HoverEnter и HoverLeave мы выполняем обновление update().

QEvent::HoverMove также немного отличается от QEvent::MouseMove. Рассмотрим главную окно A, содержащее дочерний элемент B, который в свою очередь содержит дочерний элемент C (все с включённым отслеживанием мыши):

Теперь, если вы переместите курсор сверху вниз посередине A, вы получите следующие события QEvent::MouseMove:

1. A::MouseMove
2. B::MouseMove
3. C::MouseMove

Вы получите те же события для QEvent::HoverMove, за исключением того, что событие всегда распространяется до главного окна независимо от того, было ли оно принято или нет. Оно будет останавливаться только с атрибутом Qt::WA_NoMousePropagation.

В этом случае события будут происходить следующим образом:

1. A::HoverMove
2. A::HoverMove, B::HoverMove
3. A::HoverMove, B::HoverMove, C::HoverMove

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

QHoverEvent::QHoverEvent(QEvent::Type type, const QPointF &pos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier)

Создаёт объект события наведения.

Параметр type должен быть QEvent::HoverEnter, QEvent::HoverLeave или QEvent::HoverMove.

pos — текущее положение курсора мыши относительно принимающего виджета, а oldPos — его предыдущее положение. modifiers содержат состояние всех модификаторов клавиатуры в момент события.

QPoint QHoverEvent::oldPos() const

Возвращает предыдущее положение курсора мыши относительно виджета, получившего событие. Если нет предыдущего положения, oldPos() вернёт то же положение, что и pos().

В событиях QEvent::HoverEnter это положение всегда QPoint(-1, -1).

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

const QPointF &QHoverEvent::oldPosF() const

Возвращает предыдущее положение курсора мыши относительно виджета, получившего событие. Если нет предыдущего положения, oldPosF() вернёт то же положение, что и posF().

В событиях QEvent::HoverEnter это положение всегда QPointF(-1, -1).

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

QPoint QHoverEvent::pos() const

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

В событиях QEvent::HoverLeave это положение всегда QPoint(-1, -1).

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

const QPointF &QHoverEvent::posF() const

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

В событиях QEvent::HoverLeave это положение всегда QPointF(-1, -1).

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