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

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

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

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

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

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

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