Тип 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 указывает идентификатор элемента, который нужно перетащить.
• 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.