Класс QGeoRectangle

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

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

Свойства

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

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

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

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

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

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

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

Геопрямоугольники никогда не могут пересекать полюса.

Несколько методов ведут себя так, как будто геопрямоугольник определяется с помощью центральной координаты, ширины геопрямоугольника в градусах и высоты геопрямоугольника в градусах.

Если высота или центр геопрямоугольника корректируются таким образом, что он пересекает один из полюсов, высота изменяется таким образом, чтобы геопрямоугольник касался, но не пересекал полюс, и чтобы центральная координата оставалась в центре геопрямоугольника.

Этот класс является Q_GADGET начиная с Qt 5.5. Его можно непосредственно использовать в C++ и QML.

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

QGeoRectangle::QGeoRectangle()

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

QGeoRectangle::QGeoRectangle(const QGeoCoordinate &center, double degreesWidth, double degreesHeight)

Создаёт новый гео-прямоугольник, центрированный в точке center, с шириной в градусах degreesWidth и высотой в градусах degreesHeight.

Если degreesHeight выведет гео-прямоугольник за пределы одного из полюсов, высота гео-прямоугольника будет усечена таким образом, что гео-прямоугольник будет доходить только до полюса. Центр гео-прямоугольника останется неизменным, а высота будет скорректирована так, чтобы центральная точка оставалась в центре усечённого гео-прямоугольника.

QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)

Создаёт новый гео-прямоугольник с координатами верхней левой точки topLeft и нижней правой точки bottomRight.

QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)

Создаёт новый гео-прямоугольник минимального размера, содержащий все координаты coordinates.

QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)

Создаёт гео-прямоугольник из содержимого other.

QGeoRectangle::QGeoRectangle(const QGeoShape &other)

Создаёт гео-прямоугольник из содержимого other.

QGeoRectangle::~QGeoRectangle()

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

QGeoCoordinate QGeoRectangle::bottomLeft() const

Возвращает координаты нижней левой точки этого гео-прямоугольника.

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

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

QGeoCoordinate QGeoRectangle::bottomRight() const

Возвращает координаты нижней правой точки этого гео-прямоугольника.

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

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

QGeoCoordinate QGeoRectangle::center() const

Возвращает центр этого гео-прямоугольника. Эквивалентно QGeoShape::center().

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

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

bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const

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

double QGeoRectangle::height() const

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

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

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

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

bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const

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

Если верхние или нижние грани обоих геопрямоугольников находятся на одном из полюсов, геопрямоугольники считаются пересекающимися, так как долгота не имеет значения, когда грани находятся на полюсе.

void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)

Устанавливает координату нижнего левого угла этого геопрямоугольника в bottomLeft.

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

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

void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)

Устанавливает координату нижнего правого угла этого геопрямоугольника в bottomRight.

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

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

void QGeoRectangle::setCenter(const QGeoCoordinate &center)

Устанавливает центр этого геопрямоугольника в center.

Если это приводит к пересечению геопрямоугольника с одним из полюсов, высота геопрямоугольника будет усечена таким образом, чтобы геопрямоугольник простирался только до полюса. Центр геопрямоугольника останется неизменным, а высота будет скорректирована таким образом, чтобы центральная точка находилась в центре усеченного геопрямоугольника.

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

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

void QGeoRectangle::setHeight(double degreesHeight)

Устанавливает высоту этого геопрямоугольника в градусах в degreesHeight.

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

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

void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)

Устанавливает координату верхнего левого угла этого геопрямоугольника в topLeft.

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

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

void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)

Устанавливает координату верхнего правого угла этого геопрямоугольника в topRight.

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

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

void QGeoRectangle::setWidth(double degreesWidth)

Устанавливает ширину этого геопрямоугольника в градусах в degreesWidth.

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

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

QString QGeoRectangle::toString() const

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

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

QGeoCoordinate QGeoRectangle::topLeft() const

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

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

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

QGeoCoordinate QGeoRectangle::topRight() const

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

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

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

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

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

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

Если перемещение приведет к пересечению полюса, геопрямоугольник будет перемещаться до тех пор, пока верхняя или нижняя граница геопрямоугольника не коснется полюса, но не дальше.

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

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

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

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

QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const

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

Если центры двух геопрямоугольников разделены ровно на 180,0 градусов, ширина устанавливается в 360,0 градусов, а левая долгота устанавливается в -180,0 градусов, а правая долгота в 180,0 градусов. Это делается для обеспечения независимости результата от порядка операндов.

double QGeoRectangle::width() const

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

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

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

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

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

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

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

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

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

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

QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const

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

Если центры двух геопрямоугольников разделены ровно на 180,0 градусов, ширина устанавливается в 360,0 градусов, а левая долгота устанавливается в -180,0 градусов, а правая долгота в 180,0 градусов. Это делается для обеспечения независимости результата от порядка операндов.

QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)

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

Если центры двух геопрямоугольников разделены ровно на 180,0 градусов, ширина устанавливается в 360,0 градусов, а левая долгота устанавливается в -180,0 градусов, а правая долгота в 180,0 градусов. Это делается для обеспечения независимости результата от порядка операндов.