Тип QML MapGestureArea

Тип MapGestureArea предоставляет взаимодействие с жестами карты. Подробнее...

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

Свойства

• acceptedGestures : перечисление
• enabled : bool
• flickDeceleration : real
• maximumZoomLevelChange : real
• panActive : bool
• pinchActive : bool
• preventStealing : bool

Сигналы

• flickFinished()
• flickStarted()
• panFinished()
• panStarted()
• pinchFinished(PinchEvent event)
• pinchStarted(PinchEvent event)
• pinchUpdated(PinchEvent event)

Подробное описание

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

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

Два наиболее часто используемых свойства MapGestureArea — это свойства enabled и acceptedGestures. Оба эти свойства должны быть установлены перед тем, как MapGestureArea повлияет на взаимодействие с картой. Свойство flickDeceleration управляет скоростью замедления перемещения карты после отпускания при перемещении карты.

Производительность

MapGestureArea, когда он включен, должен обрабатывать все входящие события касания, чтобы отслеживать форму и размер «щипка». Надстройка, добавленная для событий касания, может считаться постоянным временем.

Пример использования

В следующем примере включены жесты масштабирования и перемещения на карте, но не включено быстрое перемещение. Таким образом, прокрутка карты будет немедленно остановлена при отпускании кнопки мыши/касания.

Map {
    gesture.enabled: true
    gesture.acceptedGestures: MapGestureArea.PinchGesture | MapGestureArea.PanGesture
}

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

acceptedGestures : перечисление

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

• MapGestureArea.NoGesture - Не поддерживаются дополнительные жесты (значение: 0x0000).
• MapGestureArea.PinchGesture - Поддерживается жест масштабирования карты с помощью пинцета (значение: 0x0001).
• MapGestureArea.PanGesture - Поддерживается жест перемещения карты (значение: 0x0002).
• MapGestureArea.FlickGesture - Поддерживается жест быстрого перемещения карты (значение: 0x0004).

enabled : bool

Это свойство указывает, включены ли жесты.

flickDeceleration : real

Это свойство задает скорость замедления при быстром перемещении.

Значение по умолчанию — 2500.

maximumZoomLevelChange : real

Это свойство задаёт максимальное изменение уровня масштабирования при использовании пинцета, по существу, предназначено для настройки чувствительности масштабирования.

Это показательный параметр, рассчитанный по размерам области карты, примерно соответствующий тому, насколько может измениться уровень масштабирования при максимальном масштабировании с помощью пинцета. Значение по умолчанию — 4,0, максимальное значение — 10,0.

panActive : bool

Это только для чтения свойство указывает, активен ли жест перемещения.

Примечание: Уведомления о изменениях для этого свойства были введены в Qt 5.5.

pinchActive : bool

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

preventStealing : bool

Это свойство указывает, могут ли события мыши быть украдены этим MapGestureArea.

Если карта размещена внутри элемента, который фильтрует события мыши и касания дочерних элементов, например, Flickable, события мыши и касания могут быть украдены у MapGestureArea, если родительский элемент распознает жест, например, жест быстрого перемещения. Если preventStealing установлено в true, ни один элемент не украдет события мыши и касания.

Обратите внимание, что установка preventStealing в true, когда элемент уже начал красть события, не повлияет до следующего события нажатия.

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

Документация по сигналам

flickFinished()

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

Соответствующий обработчик — onFlickFinished.

flickStarted()

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

Соответствующий обработчик — onFlichStarted.

panFinished()

Этот сигнал испускается, когда карта перестает двигаться из-за взаимодействия пользователя. Если было инициировано быстрое перемещение, этот сигнал испускается до начала быстрого перемещения. Если быстрое перемещение не было инициировано, этот сигнал испускается, когда пользователь прекращает перетаскивание - то есть отпускает кнопку мыши или касание.

Соответствующий обработчик — onPanFinished.

panStarted()

Этот сигнал испускается, когда карта начинает двигаться из-за взаимодействия пользователя. Обычно это означает, что пользователь перетаскивает палец - или мышь с нажатой одной или несколькими кнопками мыши - по карте.

Соответствующий обработчик — onPanStarted.

pinchFinished(PinchEvent event)

Этот сигнал испускается в конце жеста масштабирования с помощью пинцета.

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

См. также pinchStarted и pinchUpdated.

pinchStarted(PinchEvent event)

Этот сигнал испускается при начале жеста масштабирования с помощью пинцета.

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

См. также pinchUpdated и pinchFinished.

pinchUpdated(PinchEvent event)

Этот сигнал испускается, когда пальцы пользователя перемещаются по карте после испускания сигнала pinchStarted.

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

См. также pinchStarted и pinchFinished.