Тип QML PinchArea

Обеспечивает простое управление жестами 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 масштаб.
• pinch.minimumRotation и pinch.maximumRotation ограничивают диапазон свойства Item.rotation, но не свойства PinchEvent поворот.
• 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.

[since 5.5] smartZoom(PinchEvent pinch)

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

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

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

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