Класс QGeoPolygon

Класс QGeoPolygon определяет географический многоугольник. Подробнее...

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

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

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

Многоугольник определяется упорядоченным списком объектов QGeoCoordinate, представляющих его периметр.

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

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

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

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

QGeoPolygon::QGeoPolygon(const QGeoShape &other)

Создает новый гео-многоугольник из содержимого other.

QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)

Создает новый гео-многоугольник из содержимого other.

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

Создает новый гео-многоугольник из координат, указанных в path.

QGeoPolygon::QGeoPolygon()

Создает новый пустой гео-многоугольник.

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

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

QGeoPolygon::~QGeoPolygon()

Уничтожает этот многоугольник.

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

Добавляет coordinate в многоугольник.

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

[invokable, since 5.12] void QGeoPolygon::addHole(const QVariant &holePath)

Устанавливает holePath для отверстия внутри многоугольника. Отверстие — это QVariant, содержащий QList<QGeoCoordinate>.

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

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

[since 5.12] void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)

Перегруженный метод. Устанавливает holePath для отверстия внутри многоугольника. Отверстие — это QList<QGeoCoordinate>.

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

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

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

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

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

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

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

[invokable, since 5.12] const QVariantList QGeoPolygon::hole(qsizetype index) const

Возвращает QVariant, содержащий QList<QGeoCoordinate>, который представляет отверстие по индексу index.

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

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

[since 5.12] const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const

Возвращает QList<QGeoCoordinate>, представляющую отверстие по индексу index.

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

[invokable, since 5.12] qsizetype QGeoPolygon::holesCount() const

Возвращает количество отверстий.

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

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

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

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

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

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

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

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

[since QtPositioning 5.12] const QList<QGeoCoordinate> &QGeoPolygon::perimeter() const

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

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

Данная функция была добавлена в QtPositioning 5.12.

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

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

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

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

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

Удаляет элемент по индексу index из многоугольника.

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

[invokable, since 5.12] void QGeoPolygon::removeHole(qsizetype index)

Удаляет элемент по индексу index из списка отверстий.

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

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

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

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

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

[since QtPositioning 5.12] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)

Устанавливает периметр многоугольника на основе списка координат path.

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

Данная функция была добавлена в QtPositioning 5.12.

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

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

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

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

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

[invokable] QString QGeoPolygon::toString() const

Возвращает свойства гео-многоугольника в виде строки.

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

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

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

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

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

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

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

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

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