Тип QML WheelEvent

Предоставляет информацию о событии вращения мыши. Подробнее...

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

Свойства

• accepted : bool
• angleDelta : point
• buttons : int
• inverted : bool
• modifiers : int
• pixelDelta : point
• x : real
• y : real

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

Позицию курсора мыши можно найти с помощью свойств x и y.

См. также WheelHandler и MouseArea.

Документация по свойствам

Эти свойства содержат координаты позиции, предоставленные событием вращения колесика.

См. также QWheelEvent::position().

accepted : bool

Установка accepted в true предотвращает распространение события вращения колесика на элементы ниже принимающего элемента или обработчика.

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

См. также QWheelEvent::accepted.

angleDelta : point

Это свойство содержит относительную величину поворота колесика в восьмых градусах. Координаты x и y этого свойства содержат дельту в горизонтальном и вертикальном направлениях соответственно.

Положительное значение указывает, что колесико было повернуто вверх/вправо; отрицательное значение указывает, что колесико было повернуто вниз/влево.

Большинство типов мыши работают с шагом в 15 градуса, в этом случае значение дельты является кратным 120; т. е., 120 units * 1/8 = 15 degrees.

См. также QWheelEvent::angleDelta().

buttons : int

Это свойство содержит нажатые кнопки мыши во время генерации события вращения колесика.

Он содержит побитовое сочетание:

• Qt.LeftButton
• Qt.RightButton
• Qt.MiddleButton

См. также QWheelEvent::buttons().

inverted : bool

Возвращает, инвертированы ли значения дельты, передаваемые вместе с событием.

Обычно вертикальное вращение колесика порождает WheelEvent с положительными значениями дельты, если верхняя часть колесика вращается от руки, управляющей им. Аналогично, горизонтальное перемещение колесика порождает QWheelEvent с положительными значениями дельты, если верхняя часть колесика перемещается влево.

Однако на некоторых платформах это настраивается, так что те же операции, описанные выше, будут давать отрицательные значения дельты (но с той же величиной). Например, в компоненте QML (таком как ползунок или ползунок), где уместно синхронизировать движение или вращение элемента с направлением колесика, независимо от системных настроек, обработчик событий колесика может использовать свойство inverted, чтобы решить, нужно ли умножить значения angleDelta или pixelDelta на -1.

См. также QWheelEvent::inverted().

modifiers : int

Это свойство содержит флаги модификаторов клавиатуры, которые существовали непосредственно перед возникновением события.

Он содержит побитовое сочетание:

• Qt.NoModifier - Ни одна клавиша модификатора не нажата.
• Qt.ShiftModifier - Нажата клавиша Shift.
• Qt.ControlModifier - Нажата клавиша Ctrl.
• Qt.AltModifier - Нажата клавиша Alt.
• Qt.MetaModifier - Нажата клавиша Meta.
• Qt.KeypadModifier - Нажата кнопка дополнительной клавиатуры.

Например, для реакции на нажатие клавиши Control во время события вращения колесика:

WheelHandler {
    onWheel: (wheel)=> {
        if (wheel.modifiers & Qt.ControlModifier) {
            adjustZoom(wheel.angleDelta.y / 120);
        }
    }
}

См. также QWheelEvent::modifiers().

pixelDelta : point

Это свойство содержит дельту в пикселях экрана и доступно на платформах с высокоразрешающими трекпадами, такими как macOS. Координаты x и y этого свойства содержат дельту в горизонтальном и вертикальном направлениях соответственно. Значения можно использовать непосредственно для прокрутки содержимого на экране.

На платформах без поддержки высокоразрешающего трекпада pixelDelta всегда будет (0,0), и вместо этого следует использовать angleDelta.

См. также QWheelEvent::pixelDelta().