Класс 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

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

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

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

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.