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

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