Тип QML PinchArea

Обеспечивает обработку простых жестов pinch. Подробнее...

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

Свойства

• enabled : bool
• pinch
  • pinch.target : Item
  • pinch.active : bool
  • pinch.minimumScale : real
  • pinch.maximumScale : real
  • pinch.minimumRotation : real
  • pinch.maximumRotation : real
  • pinch.dragAxis : перечисление
  • pinch.minimumX : real
  • pinch.maximumX : real
  • pinch.minimumY : real
  • pinch.maximumY : real

Сигналы

• pinchFinished()
• pinchStarted()
• pinchUpdated()
• smartZoom()

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

Тип 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.target : Item

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

• pinch.target указывает id элемента, который нужно перетаскивать.
• 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()

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

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

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

pinchStarted()

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

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

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

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

pinchUpdated()

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

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

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

smartZoom()

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

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

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

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