Тип 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.
Устанавливает 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