Тип QML Navigator

Тип Navigator предоставляет функциональность для выполнения навигации по шагам. Подробнее...

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

Свойства

• active : bool
• currentRoute : Route
• currentSegment : int
• map : Map
• navigatorReady : bool
• plugin : Plugin
• positionSource : PositionSource
• route : Route
• trackPositionSource : bool

Сигналы

• destinationReached()
• waypointReached(Waypoint waypoint)

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

Navigator предназначен для использования реализации навигации по шагам плагина в приложении QML бесшовным образом. Этот объект может взять под контроль положение, ориентацию, наклон и масштаб карты, а также изменение стиля карты, элементов на карте, таких как информация о направлении. В некоторых случаях он также может ограничивать взаимодействие пользователя с картой и элементами на ней.

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

active : bool

Это свойство указывает, находится ли Navigator в режиме навигации или нет. Установите это свойство в true для запуска навигации. Установите его в false для остановки активной сессии навигации.

currentRoute : Route

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

См. также Route.

currentSegment : int

Это только для чтения свойство содержит индекс текущего RouteSegment в currentRoute.

См. также RouteSegment.

map : Map

Это свойство содержит карту, за управление которой отвечает навигатор.

Это свойство записывается один раз. После того, как у Navigator будет ассоциирована карта, любые попытки изменения свойства карты будут проигнорированы.

См. также Map.

navigatorReady : bool

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

plugin : Plugin

Это свойство содержит плагин, предоставляющий функциональность навигации.

Это свойство записывается один раз. После того, как у Navigator будет ассоциирован плагин, любые попытки изменения свойства плагина будут проигнорированы.

См. также Плагин.

positionSource : PositionSource

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

Это свойство записывается один раз. После того, как у Navigator будет ассоциирован PositionSource, любые попытки изменения свойства positionSource будут проигнорированы.

См. также PositionSource.

route : Route

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

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

См. также Route.

trackPositionSource : bool

Это свойство указывает, должен ли Navigator контролировать камеру карты, чтобы отслеживать обновления источника положения. Это свойство включено (true) по умолчанию, и установка его в false полезна в тех случаях, когда, например, пользователь начинает жестикулировать над областью карты.

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

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

destinationReached()

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

waypointReached(Waypoint waypoint)

Этот сигнал излучается, когда контрольный пункт waypoint достигнут.

См. также Waypoint.