Класс QGeoPath

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

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

Свойства

• path : const QVariantList
• width : qreal

• 3 свойства унаследованы от QGeoShape

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

• 10 открытых функций унаследовано от QGeoShape

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

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

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

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

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

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

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

Примечание: Пустой QGeoPath по умолчанию считается недействительным и пустым, так как не содержит координат.

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

QGeoPath::QGeoPath()

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

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

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

QGeoPath::QGeoPath(const QGeoPath &other)

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

QGeoPath::QGeoPath(const QGeoShape &other)

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

QGeoPath::~QGeoPath()

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

void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)

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

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

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. Длина предназначена для суммирования кратчайших расстояний для каждой пары смежных точек.

Примечание: Данную функцию можно вызывать через систему метаобъектов и из 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 соответствуют перемещению на юг и запад соответственно.

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

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

qreal QGeoPath::width() const

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

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

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

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

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

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

Присваивает other этому гео-пути и возвращает ссылку на этот гео-путь.

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

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