Тип PinchArea QML

Обеспечивает простое управление жестом pinch. Подробнее...

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

Свойства

• enabled : bool
• pinch
  • pinch.active : bool
  • pinch.dragAxis : перечисление
  • pinch.maximumRotation : вещественное
  • pinch.maximumScale : вещественное
  • pinch.maximumX : вещественное
  • pinch.maximumY : вещественное
  • pinch.minimumRotation : вещественное
  • pinch.minimumScale : вещественное
  • pinch.minimumX : вещественное
  • pinch.minimumY : вещественное
  • pinch.target : Элемент

Сигналы

• pinchFinished(PinchEvent pinch)
• pinchStarted(PinchEvent pinch)
• pinchUpdated(PinchEvent pinch)
• smartZoom(PinchEvent pinch)

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

Тип PinchArea был добавлен в QtQuick 1.1

PinchArea — это невидимый элемент, который обычно используется совместно с видимым элементом для обработки жеста pinch для этого элемента.

Свойство enabled используется для включения и отключения обработки pinch для проксируемого элемента. При отключении область pinch становится прозрачной для событий мыши/сенсорного ввода.

PinchArea можно использовать двумя способами:

• установив pinch.target для обеспечения автоматического взаимодействия с элементом
• используя обработчики onPinchStarted, onPinchUpdated и onPinchFinished

Начиная с Qt 5.5, PinchArea может реагировать на собственные жесты pinch от операционной системы, если они доступны; в противном случае он реагирует только на события сенсорного ввода.

См. также PinchEvent, QNativeGestureEvent и QTouchEvent.

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

enabled : bool

Это свойство указывает, принимает ли элемент жесты pinch.

По умолчанию это свойство равно true.

pinch.active : bool

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

• pinch.target указывает идентификатор элемента, который нужно перетащить.
• pinch.active указывает, перетаскивается ли целевой элемент в данный момент.
• pinch.minimumScale и pinch.maximumScale ограничивают диапазон свойства Item.scale, но не свойства PinchEvent scale.
• pinch.minimumRotation и pinch.maximumRotation ограничивают диапазон свойства Item.rotation, но не свойства PinchEvent rotation.
• pinch.dragAxis указывает, разрешен ли перетаскивание (Pinch.NoDrag), можно ли делать его по горизонтали (Pinch.XAxis), по вертикали (Pinch.YAxis) или по обоим осям (Pinch.XAndYAxis)
• pinch.minimum и pinch.maximum ограничивают, насколько далеко можно перетащить целевой элемент вдоль соответствующих осей.

Документация по сигналам

pinchFinished(PinchEvent pinch)

Этот сигнал излучается, когда область pinch обнаруживает, что жест pinch завершен.

Параметр pinch (не то же самое, что свойство pinch) предоставляет информацию о жесте pinch, включая масштаб, центр и угол жеста.

Примечание: Соответствующий обработчик — onPinchFinished.

pinchStarted(PinchEvent pinch)

Этот сигнал излучается, когда область pinch обнаруживает, что жест pinch начался: были обнаружены две точки касания (пальцы), и они сместились за порог startDragDistance для начала жеста.

Параметр pinch (не то же самое, что свойство pinch) предоставляет информацию о жесте pinch, включая масштаб, центр и угол жеста. В момент излучения сигнала pinchStarted, эти значения сбрасываются до значений по умолчанию, независимо от результатов предыдущих жестов: pinch.scale будет 1.0, а pinch.rotation — 0.0. По мере развития жеста pinchUpdated будет сообщать об отклонении от этих значений по умолчанию.

Чтобы пропустить этот жест, установите свойство pinch.accepted в значение false. Жест будет отменён, и больше событий не будут отправлены.

Примечание: Соответствующий обработчик — onPinchStarted.

pinchUpdated(PinchEvent pinch)

Этот сигнал излучается, когда область pinch обнаруживает, что жест pinch изменился.

Параметр pinch предоставляет информацию о жесте pinch, включая масштаб, центр и угол жеста. Эти значения отражают изменения только с момента начала текущего жеста, и поэтому не ограничены минимальными и максимальными значениями в свойстве pinch.

Примечание: Соответствующий обработчик — onPinchUpdated.

smartZoom(PinchEvent pinch)

Этот сигнал излучается, когда область pinch обнаруживает жест smart zoom. Этот жест происходит только на некоторых операционных системах, таких как macOS.

Параметр pinch предоставляет информацию о жесте pinch, включая местоположение, где произошел жест. pinch.scale будет больше нуля, когда жест указывает, что пользователь хочет войти в режим smart zoom, и ноль — при выходе (хотя, обычно, используется тот же самый жест для переключения между двумя состояниями).

Примечание: Соответствующий обработчик — onSmartZoom.

Этот сигнал был введён в Qt 5.5.