Класс QGeoPath

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

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

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

Свойства

• path : const QVariantList
• width : qreal

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

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

Траектория определяется упорядоченным списком QGeoCoordinates.

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

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

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

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

Примечание: 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()

Удаляет эту траекторию.

void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)

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

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

void QGeoPath::clearPath()

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

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

bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const

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

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

QGeoCoordinate QGeoPath::coordinateAt(int index) const

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

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

void QGeoPath::insertCoordinate(int index, const QGeoCoordinate &coordinate)

Вставляет coordinate в указанный индекс index.

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

double QGeoPath::length(int indexFrom = 0, int indexTo = -1) const

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

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

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

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

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

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

void QGeoPath::removeCoordinate(const QGeoCoordinate &coordinate)

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

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

void QGeoPath::removeCoordinate(int index)

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

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

void QGeoPath::replaceCoordinate(int index, const QGeoCoordinate &coordinate)

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

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

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

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

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

int QGeoPath::size() const

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

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

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

QString QGeoPath::toString() const

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

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

void QGeoPath::translate(double degreesLatitude, double degreesLongitude)

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

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

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

QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const

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

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

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

qreal QGeoPath::width() const

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

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

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

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

Возвращает значение true, если этот гео-путь не равен other.

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

Возвращает значение true, если этот гео-путь равен other.