Spec-Zone.ru › Qt 5.11

Тип QML MapPolyline

Тип MapPolyline отображает полилинию на карте. Подробнее...

Заявление об импорте: import QtLocation 5.11
С момента: QtLocation 5.0
  • Список всех членов, включая унаследованные

Свойства

  • line
    • line.width : int
    • line.color : цвет
  • path : список<координата>

Методы

  • void addCoordinate(координата)
  • координата containsCoordinate(координата)
  • координата coordinateAt(индекс)
  • void insertCoordinate(индекс, координата)
  • int pathLength()
  • void removeCoordinate(индекс)
  • void removeCoordinate(координата)
  • void replaceCoordinate(индекс, координата)
  • int setPath(геопуть path)

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

Тип MapPolyline отображает полилинию на карте, заданную в виде упорядоченного списка координат. Координаты на пути не могут быть непосредственно изменены после добавления в полилинию. Вместо этого скопируйте path в переменную, измените копию и присвойте копию обратно path.

var path = mapPolyline.path;
path[0].latitude = 5;
mapPolyline.path = path;

Координаты также можно добавлять и удалять в любое время с помощью методов addCoordinate и removeCoordinate.

По умолчанию полилиния отображается как черная линия толщиной 1 пиксель. Это можно изменить, используя свойства line.width и line.color.

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

MapPolylines имеют стоимость отрисовки O(n) относительно количества вершин. Это означает, что стоимость за кадр отрисовки полилинии на карте увеличивается прямо пропорционально количеству точек в полилинии.

Как и другие объекты карты, MapPolyline обычно отображается без плавного внешнего вида. Установка свойства opacity заставит объект смешиваться, что значительно снизит производительность в зависимости от используемого оборудования.

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

Следующий фрагмент кода демонстрирует MapPolyline с 4 точками, формирующими фигуру, похожую на верхнюю часть знака вопроса (?), около Брисбена, Австралия. Отображаемая линия имеет ширину 3 пикселя и зелёного цвета.

Map {
    MapPolyline {
        line.width: 3
        line.color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 },
            { latitude: -29, longitude: 153.5 }
        ]
    }
}

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

line.width : int

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

Ширина в пикселях и не зависит от уровня масштабирования карты. Значения по умолчанию соответствуют черному контуру шириной 1 пиксель.

Для отсутствия линии используйте ширину 0 или прозрачный цвет.

path : список<координата>

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

Документация по методам

void addCoordinate(координата)

Добавляет координату в конец пути.

См. также insertCoordinate, removeCoordinate и path.

координата containsCoordinate(координата)

Возвращает true, если заданная координата является частью пути.

Этот метод был представлен в QtLocation 5.6.

координата coordinateAt(индекс)

Получает координату полилинии по заданному индексу. Если индекс находится вне границ пути, возвращается недействительная координата.

Этот метод был представлен в QtLocation 5.6.

void insertCoordinate(индекс, координата)

Вставляет координату в путь по заданному индексу.

Этот метод был представлен в QtLocation 5.6.

См. также addCoordinate, removeCoordinate и path.

int pathLength()

Возвращает количество координат полилинии.

Этот метод был представлен в QtLocation 5.6.

См. также path.

void removeCoordinate(индекс)

Удаляет координату из пути по заданному индексу.

Если индекс недействителен, этот метод ничего не делает.

Этот метод был представлен в QtLocation 5.6.

См. также addCoordinate, insertCoordinate и path.

void removeCoordinate(координата)

Удаляет координату из пути. Если существуют несколько экземпляров одной и той же координаты, удаляется последняя добавленная.

Если координата не находится в пути, этот метод ничего не делает.

См. также addCoordinate, insertCoordinate и path.

void replaceCoordinate(индекс, координата)

Заменяет координату в текущем пути по заданному индексу новой координатой.

Этот метод был представлен в QtLocation 5.6.

См. также addCoordinate, insertCoordinate, removeCoordinate и path.

int setPath(геопуть path)

Устанавливает path с использованием типа QGeoPath.

Этот метод был представлен в Qt 5.10.

См. также path.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qml-qtlocation-mappolyline.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API