Класс QGeoPath

Класс QGeoPath определяет географическую траекторию. Подробнее...

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

Свойства

• path : const QVariantList
• width : qreal

Открытые функции

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

Траектория определяется упорядоченным списком объектов QGeoCoordinate.

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

Это актуально для расчета области, возвращаемой QGeoShape::boundingGeoRectangle() для этой фигуры, которая будет иметь широту верхнего левого угла, установленную как максимальную широту в наборе точек траектории. Аналогично, широта нижнего правого угла будет минимальной широтой в наборе точек траектории.

Этот класс является Q_GADGET. Он может быть непосредственно использован из C++ и QML.

QGeoPath недействителен и пуст, если он не содержит координат.

Документация функций-членов

QGeoPath::QGeoPath(const QGeoShape &other)

Создаёт новую географическую траекторию из содержимого other.

QGeoPath::QGeoPath(const QGeoPath &other)

Создаёт новую географическую траекторию из содержимого other.

QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)

Создаёт новую географическую траекторию из списка координат (path и width).

QGeoPath::QGeoPath()

Создаёт новую пустую географическую траекторию.

QGeoPath &QGeoPath::operator=(const QGeoPath &other)

Присваивает other этой географической траектории и возвращает ссылку на эту географическую траекторию.

QGeoPath::~QGeoPath()

Уничтожает эту траекторию.

[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)

Добавляет coordinate в траекторию.

Примечание: Эту функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[since 5.12] void QGeoPath::clearPath()

Очищает траекторию.

Эта функция была добавлена в Qt 5.12.

[invokable] bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const

Возвращает true, если траектория содержит coordinate в качестве одного из элементов.

Примечание: Эту функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] QGeoCoordinate QGeoPath::coordinateAt(qsizetype index) const

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

Примечание: Эту функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] void QGeoPath::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)

Вставляет coordinate по указанному index.

Примечание: Эту функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] double QGeoPath::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const

Возвращает длину пути в метрах от элемента indexFrom до элемента indexTo. Длина предназначена для суммирования кратчайших расстояний для каждой пары смежных точек.

Если indexTo равно -1 (значение по умолчанию), длина будет включать расстояние между последней координатой и первой (замкнутая петля). Чтобы получить длину пути, используйте 0 для indexFrom и QGeoPath::size() - 1 для indexTo.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

const QList<QGeoCoordinate> &QGeoPath::path() const

Возвращает все элементы пути.

См. также setPath().

[invokable] void QGeoPath::removeCoordinate(const QGeoCoordinate &coordinate)

Удаляет последнее вхождение coordinate из пути.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] void QGeoPath::removeCoordinate(qsizetype index)

Удаляет элемент в позиции index из пути.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] void QGeoPath::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)

Заменяет элемент пути в указанном index на coordinate.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QGeoPath::setPath(const QList<QGeoCoordinate> &path)

Устанавливает все элементы path.

См. также path().

[invokable, since 5.10] qsizetype QGeoPath::size() const

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

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

Функция была добавлена в Qt 5.10.

[invokable] QString QGeoPath::toString() const

Возвращает свойства гео-пути в виде строки.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] void QGeoPath::translate(double degreesLatitude, double degreesLongitude)

Перемещает этот гео-путь на degreesLatitude градусов к северу и degreesLongitude градусов к востоку.

Отрицательные значения degreesLatitude и degreesLongitude соответствуют перемещению на юг и запад соответственно.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

[invokable] QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const

Возвращает копию этого гео-пути, перемещенного на degreesLatitude градусов к северу и degreesLongitude градусов к востоку.

Отрицательные значения degreesLatitude и degreesLongitude соответствуют перемещению на юг и запад соответственно.

См. также translate().

qreal QGeoPath::width() const

Возвращает ширину пути в метрах. Эта информация используется в методе contains. Значение по умолчанию равно 0.

Примечание: Функция-геттер для свойства width.

См. также setWidth().