Тип 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 свойства 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.

[since 5.5] smartZoom(PinchEvent pinch)

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

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

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

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