Тип PinchArea QML

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

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

Свойства

• enabled : bool
• pinch
  • pinch.target : Элемент
  • pinch.active : bool
  • pinch.minimumScale : вещественное
  • pinch.maximumScale : вещественное
  • pinch.minimumRotation : вещественное
  • pinch.maximumRotation : вещественное
  • pinch.dragAxis : перечисление
  • pinch.minimumX : вещественное
  • pinch.maximumX : вещественное
  • pinch.minimumY : вещественное
  • pinch.maximumY : вещественное

Сигналы

• 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 : Элемент

pinch предоставляет удобный способ заставить элемент реагировать на жесты pinch.

• pinch.target указывает идентификатор элемента, который нужно перетащить.
• pinch.active указывает, является ли целевой элемент в настоящее время перетаскиваемым.
• pinch.minimumScale и pinch.maximumScale ограничивают диапазон свойства Item.scale, но не PinchEvent свойства масштаба.
• pinch.minimumRotation и pinch.maximumRotation ограничивают диапазон свойства Item.rotation, но не PinchEvent свойства поворота.
• 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.