Тип PinchArea QML

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

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

Свойства

• enabled : bool
• pinch
  • pinch.target : Элемент
  • 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, если они доступны; в противном случае он реагирует только на события touch.

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

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

enabled : bool

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

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

pinch.target : Элемент

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.