Тип PinchArea QML

Обеспечивает простое управление жестом масштабирования. Подробнее...

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

Свойства

• 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 — это невидимый элемент, который обычно используется совместно с видимым элементом для обработки жестов масштабирования для этого элемента.

Свойство enabled используется для включения и отключения обработки жестов масштабирования для проксируемого элемента. При отключении область масштабирования становится прозрачной для событий мыши/сенсорного экрана.

PinchArea может быть использован двумя способами:

• установив pinch.target для обеспечения автоматического взаимодействия с элементом
• используя обработчики onPinchStarted, onPinchUpdated и onPinchFinished

Начиная с Qt 5.5, PinchArea может реагировать на собственные жесты масштабирования с операционной системы, если они доступны; в противном случае он реагирует только на события сенсорного экрана.

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

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

enabled : bool

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

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

pinch.active : bool

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) предоставляет информацию о жесте масштабирования, включая масштаб, центр и угол масштабирования.

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

pinchStarted(PinchEvent pinch)

Этот сигнал испускается, когда область масштабирования обнаруживает начало жеста масштабирования: было обнаружено две точки соприкосновения (пальца), и они сместились за порог startDragDistance для начала жеста.

Параметр pinch (не тот же, что и свойство pinch) предоставляет информацию о жесте масштабирования, включая масштаб, центр и угол масштабирования. В момент испускания сигнала pinchStarted эти значения сбрасываются до значений по умолчанию, независимо от результатов предыдущих жестов: pinch.scale будет 1.0, а pinch.rotation — 0.0. По мере развития жеста pinchUpdated будет сообщать об отклонениях от этих значений по умолчанию.

Чтобы проигнорировать этот жест, установите свойство pinch.accepted в false. Жест будет отменен, и дальнейшие события не будут отправлены.

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

pinchUpdated(PinchEvent pinch)

Этот сигнал испускается, когда область масштабирования обнаруживает изменение жеста масштабирования.

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

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

[since 5.5] smartZoom(PinchEvent pinch)

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

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

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

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