Тип Navigator QML

Тип 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

Это свойство содержит Map, за которым навигатор отвечает.

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

См. также Map.

navigatorReady : bool

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

plugin : Plugin

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

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

См. также Plugin.

positionSource : PositionSource

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

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

См. также PositionSource.

route : Route

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

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

См. также Route.

trackPositionSource : bool

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

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

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

destinationReached()

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

waypointReached(Waypoint waypoint)

Этот сигнал испускается, когда достигнута точка waypoint.

См. также Waypoint.