Тип 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()
• 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.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()

Этот сигнал излучается, когда область 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.