Класс QRectF

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

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

Примечание: Все функции в этом классе являются реентерабельными.

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

Статические публичные члены

Связанные нечлены

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

Класс QRectF определяет прямоугольник на плоскости с плавающей точкой.

Прямоугольник обычно выражается как верхний левый угол и размер. Размер (QRectF) всегда эквивалентен математическому прямоугольнику, который служит основой для его отрисовки.

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

QRectF r1(100.0, 200.1, 11.2, 16.3);
QRectF r2(QPointF(100.0, 200.1), QSizeF(11.2, 16.3));

Также существует третий конструктор, создающий QRectF из QRect, и соответствующая функция toRect(), которая возвращает объект QRect на основе значений этого прямоугольника (обратите внимание, что координаты в возвращаемом прямоугольнике округляются до ближайшего целого числа).

Класс QRectF предоставляет набор функций, которые возвращают различные координаты прямоугольника и позволяют управлять ими. QRectF также предоставляет функции для перемещения прямоугольника относительно различных координат. Кроме того, есть функция moveTo(), которая перемещает прямоугольник, оставив его верхний левый угол в заданных координатах. В качестве альтернативы, функция translate() перемещает прямоугольник на заданный смещение относительно текущего положения, а функция translated() возвращает скопированный и перемещенный прямоугольник.

Функция size() возвращает размеры прямоугольника в виде QSizeF. Размеры также можно получить отдельно с помощью функций width() и height(). Для изменения размеров используйте функции setSize(), setWidth() или setHeight(). В качестве альтернативы, размеры можно изменить, применив любую из функций, устанавливающих координаты прямоугольника, например, setBottom() или setRight().

Функция contains() указывает, находится ли заданная точка внутри прямоугольника, а функция intersects() возвращает true , если этот прямоугольник пересекается с заданным прямоугольником (в противном случае false). Класс QRectF также предоставляет функцию intersected(), которая возвращает прямоугольник пересечения, и функцию united(), которая возвращает прямоугольник, содержащий заданный прямоугольник и текущий:

intersected()	united()

Функция isEmpty() возвращает true , если ширина или высота прямоугольника меньше или равна 0. Обратите внимание, что пустой прямоугольник недействителен: функция isValid() возвращает true , если и ширина, и высота больше 0. С другой стороны, нулевой прямоугольник (isNull() == true) имеет и ширину, и высоту, равные 0.

Обратите внимание, что из-за того, как определены QRect и QRectF, пустой QRectF определяется по существу так же, как QRect.

Наконец, объекты QRectF могут быть переданы и сравнены.

Отрисовка

При использовании антиалиасингового художника, граничная линия QRectF будет отрисовываться симметрично с обеих сторон от граничной линии математического прямоугольника. Но при использовании алиасингового художника (по умолчанию) применяются другие правила.

Затем, при отрисовке с пером шириной в один пиксель граничная линия QRectF будет отрисовываться справа и снизу от граничной линии математического прямоугольника.

При отрисовке пером шириной в два пикселя граничная линия будет разделена пополам математическим прямоугольником. Это будет справедливо всякий раз, когда ширина пера представляет собой четное число пикселей, в то время как при отрисовке пером с нечетным числом пикселей лишний пиксель будет отрисовываться справа и снизу от математического прямоугольника, как и в случае с пером шириной в один пиксель.

Логическое представление	Перо шириной в один пиксель
Перо шириной в два пикселя	Перо шириной в три пикселя

Координаты

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

Например, функции bottom(), setBottom() и moveBottom(): bottom() возвращает y-координату нижнего края прямоугольника, setBottom() устанавливает нижний край прямоугольника в заданную y-координату (может изменить высоту, но никогда не изменит верхний край прямоугольника), а moveBottom() перемещает весь прямоугольник вертикально, оставив нижний край прямоугольника в заданной y-координате и сохранив его размер.

Также можно добавлять смещения к координатам этого прямоугольника с помощью функции adjust(), а также получать новый прямоугольник на основе корректировок исходного прямоугольника с помощью функции adjusted(). Если либо ширина, либо высота отрицательны, используйте функцию normalized() для получения прямоугольника, где углы поменяны местами.

Кроме того, QRectF предоставляет функцию getCoords(), которая извлекает положение верхнего левого и нижнего правого угла прямоугольника, и функцию getRect(), которая извлекает верхний левый угол, ширину и высоту прямоугольника. Используйте функции setCoords() и setRect() для одновременного управления координатами и размерами прямоугольника.

См. также QRect и QRegion.

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

QRectF::QRectF()

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

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

QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)

Создает прямоугольник с заданным углом topLeft и заданным размером size.

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

QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)

Конструирует прямоугольник с заданными углами topLeft и bottomRight.

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

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

QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

Конструирует прямоугольник с верхним левым углом (x, y) и заданной шириной и высотой.

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

QRectF::QRectF(const QRect &rectangle)

Конструирует прямоугольник QRectF из заданного прямоугольника QRect rectangle.

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

void QRectF::adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2)

Добавляет значения dx1, dy1, dx2 и dy2 соответственно к существующим координатам прямоугольника.

См. также adjusted() и setRect().

QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const

Возвращает новый прямоугольник, с добавленными значениями dx1, dy1, dx2 и dy2 соответственно к существующим координатам этого прямоугольника.

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

qreal QRectF::bottom() const

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

См. также setBottom(), bottomLeft(), и bottomRight().

QPointF QRectF::bottomLeft() const

Возвращает позицию нижнего левого угла прямоугольника.

См. также setBottomLeft(), bottom(), и left().

QPointF QRectF::bottomRight() const

Возвращает позицию нижнего правого угла прямоугольника.

См. также setBottomRight(), bottom(), и right().

QPointF QRectF::center() const

Возвращает центральную точку прямоугольника.

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

bool QRectF::contains(const QPointF &point) const

Возвращает true если заданная точка point находится внутри или на границе прямоугольника; в противном случае возвращает false.

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

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

Это перегруженный метод.

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

bool QRectF::contains(qreal x, qreal y) const

Это перегруженный метод.

Возвращает true если точка (x, y) находится внутри или на границе прямоугольника; в противном случае возвращает false.

[static] QRectF QRectF::fromCGRect(CGRect rect)

Создаёт QRectF из CGRect rect.

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

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

void QRectF::getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *y2) const

Извлекает координаты верхнего левого угла прямоугольника в *x1 и *y1, и координаты нижнего правого угла в *x2 и *y2.

См. также setCoords() и getRect().

void QRectF::getRect(qreal *x, qreal *y, qreal *width, qreal *height) const

Извлекает координаты верхнего левого угла прямоугольника в *x и *y, и его размеры в *width и *height.

См. также setRect() и getCoords().

qreal QRectF::height() const

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

См. также setHeight(), width(), и size().

QRectF QRectF::intersected(const QRectF &rectangle) const

Возвращает пересечение этого прямоугольника и заданного прямоугольника rectangle. Обратите внимание, что r.intersected(s) эквивалентно r & s.

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

См. также intersects(), united(), и operator&=().

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

Возвращает true если этот прямоугольник пересекается с заданным прямоугольником rectangle (т.е. существует непустая область перекрытия между ними), в противном случае возвращает false.

Прямоугольник пересечения может быть получен с помощью функции intersected().

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

bool QRectF::isEmpty() const

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

Пустой прямоугольник имеет width() <= 0 или height() <= 0. Пустой прямоугольник не является допустимым (т.е., isEmpty() == !isValid()).

Используйте функцию normalized() для получения прямоугольника, где углы поменяны местами.

См. также isNull(), isValid(), и normalized().

bool QRectF::isNull() const

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

Нулевой прямоугольник имеет ширину и высоту, равные 0. Нулевой прямоугольник также пуст и, следовательно, не является допустимым.

См. также isEmpty() и isValid().

bool QRectF::isValid() const

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

Допустимый прямоугольник имеет ширину width() > 0 и высоту height() > 0. Обратите внимание, что нетривиальные операции, такие как пересечения, не определены для недопустимых прямоугольников. Допустимый прямоугольник не пуст (т.е., isValid() == !isEmpty()).

См. также isNull(), isEmpty(), и normalized().

qreal QRectF::left() const

Возвращает x-координату левой грани прямоугольника. Эквивалентно x().

См. также setLeft(), topLeft(), и bottomLeft().

QRectF QRectF::marginsAdded(const QMarginsF &margins) const

Возвращает прямоугольник, увеличенный на margins.

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

См. также operator+=(), marginsRemoved(), и operator-=().

QRectF QRectF::marginsRemoved(const QMarginsF &margins) const

Удаляет отступы из прямоугольника, уменьшая его.

Эта функция была представлена в Qt 5.3.

См. также marginsAdded(), operator+=(), и operator-=().

void QRectF::moveBottom(qreal y)

Перемещает прямоугольник вертикально, оставляя нижнюю границу прямоугольника в заданной координате y. Размер прямоугольника не изменяется.

См. также bottom(), setBottom(), и moveTop().

void QRectF::moveBottomLeft(const QPointF &position)

Перемещает прямоугольник, оставляя нижнюю левую вершину в заданной position. Размер прямоугольника не изменяется.

См. также setBottomLeft(), moveBottom(), и moveLeft().

void QRectF::moveBottomRight(const QPointF &position)

Перемещает прямоугольник, оставляя нижнюю правую вершину в заданной position. Размер прямоугольника не изменяется.

См. также setBottomRight(), moveBottom(), и moveRight().

void QRectF::moveCenter(const QPointF &position)

Перемещает прямоугольник, оставляя центр в заданной position. Размер прямоугольника не изменяется.

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

void QRectF::moveLeft(qreal x)

Перемещает прямоугольник горизонтально, оставляя левую границу прямоугольника в заданной координате x. Размер прямоугольника не изменяется.

См. также left(), setLeft(), и moveRight().

void QRectF::moveRight(qreal x)

Перемещает прямоугольник горизонтально, оставляя правую границу прямоугольника в заданной координате x. Размер прямоугольника не изменяется.

См. также right(), setRight(), и moveLeft().

void QRectF::moveTo(qreal x, qreal y)

Перемещает прямоугольник, оставляя верхний левый угол в заданной позиции (x, y). Размер прямоугольника не изменяется.

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

void QRectF::moveTo(const QPointF &position)

Это перегруженная функция.

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

void QRectF::moveTop(qreal y)

Перемещает прямоугольник вертикально, оставляя верхнюю границу прямоугольника в заданной координате y. Размер прямоугольника не изменяется.

См. также top(), setTop(), и moveBottom().

void QRectF::moveTopLeft(const QPointF &position)

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

См. также setTopLeft(), moveTop(), и moveLeft().

void QRectF::moveTopRight(const QPointF &position)

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

См. также setTopRight(), moveTop(), и moveRight().

QRectF QRectF::normalized() const

Возвращает нормализованный прямоугольник; т.е., прямоугольник с неотрицательной шириной и высотой.

Если width() < 0 функция меняет местами левые и правые углы, а также меняет местами верхние и нижние углы, если height() < 0.

См. также isValid() и isEmpty().

qreal QRectF::right() const

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

См. также setRight(), topRight(), и bottomRight().

void QRectF::setBottom(qreal y)

Устанавливает нижнюю границу прямоугольника в заданную координату y. Может изменить высоту, но никогда не изменит верхнюю границу прямоугольника.

См. также bottom() и moveBottom().

void QRectF::setBottomLeft(const QPointF &position)

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

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

void QRectF::setBottomRight(const QPointF &position)

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

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

void QRectF::setCoords(qreal x1, qreal y1, qreal x2, qreal y2)

Устанавливает координаты верхнего левого угла прямоугольника в (x1, y1), а координаты его нижнего правого угла в (x2, y2).

См. также getCoords() и setRect().

void QRectF::setHeight(qreal height)

Устанавливает высоту прямоугольника в заданную height. Нижняя граница изменяется, но верхняя нет.

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

void QRectF::setLeft(qreal x)

Устанавливает левую границу прямоугольника в заданную координату x. Может изменить ширину, но никогда не изменит правую границу прямоугольника.

Эквивалентно setX().

См. также left() и moveLeft().

void QRectF::setRect(qreal x, qreal y, qreal width, qreal height)

Устанавливает координаты верхнего левого угла прямоугольника в (x, y), а его размер в заданную width и height.

См. также getRect() и setCoords().

void QRectF::setRight(qreal x)

Устанавливает правую границу прямоугольника в заданную координату x. Может изменить ширину, но никогда не изменит левую границу прямоугольника.

См. также right() и moveRight().

void QRectF::setSize(const QSizeF &size)

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

См. также size(), setWidth(), и setHeight().

void QRectF::setTop(qreal y)

Устанавливает верхнюю границу прямоугольника в заданную координату y. Может изменить высоту, но никогда не изменит нижнюю границу прямоугольника.

Эквивалентно setY().

См. также top() и moveTop().

void QRectF::setTopLeft(const QPointF &position)

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

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

void QRectF::setTopRight(const QPointF &position)

Устанавливает верхнюю правую вершину прямоугольника в заданную position. Может изменить размер, но никогда не изменит нижнюю левую вершину прямоугольника.

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

void QRectF::setWidth(qreal width)

Устанавливает ширину прямоугольника в заданную width. Правая граница изменяется, но левая — нет.

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

void QRectF::setX(qreal x)

Устанавливает левую границу прямоугольника в заданную координату x. Может изменить ширину, но никогда не изменит правую границу прямоугольника.

Эквивалентно setLeft().

См. также x(), setY() и setTopLeft().

void QRectF::setY(qreal y)

Устанавливает верхнюю границу прямоугольника в заданную координату y. Может изменить высоту, но никогда не изменит нижнюю границу прямоугольника.

Эквивалентно setTop().

См. также y(), setX() и setTopLeft().

QSizeF QRectF::size() const

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

См. также setSize(), width() и height().

QRect QRectF::toAlignedRect() const

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

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

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

CGRect QRectF::toCGRect() const

Создаёт CGRect из QRectF.

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

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

QRect QRectF::toRect() const

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

См. также QRectF() и toAlignedRect().

qreal QRectF::top() const

Возвращает y-координату верхней границы прямоугольника. Эквивалентно y().

См. также setTop(), topLeft() и topRight().

QPointF QRectF::topLeft() const

Возвращает положение левой верхней вершины прямоугольника.

См. также setTopLeft(), top() и left().

QPointF QRectF::topRight() const

Возвращает положение правой верхней вершины прямоугольника.

См. также setTopRight(), top() и right().

void QRectF::translate(qreal dx, qreal dy)

Перемещает прямоугольник на dx по оси x и dy по оси y относительно текущего положения. Положительные значения перемещают прямоугольник вправо и вниз.

См. также moveTopLeft(), moveTo() и translated().

void QRectF::translate(const QPointF &offset)

Это перегруженная функция.

Перемещает прямоугольник на offset.x() по оси x и offset.y() по оси y относительно текущего положения.

QRectF QRectF::translated(qreal dx, qreal dy) const

Возвращает копию прямоугольника, сдвинутого на dx по оси x и dy по оси y относительно текущего положения. Положительные значения перемещают прямоугольник вправо и вниз.

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

QRectF QRectF::translated(const QPointF &offset) const

Это перегруженная функция.

Возвращает копию прямоугольника, сдвинутого на offset.x() по оси x и offset.y() по оси y относительно текущего положения.

QRectF QRectF::transposed() const

Возвращает копию прямоугольника, в которой ширина и высота поменялись местами:

QRectF r = {1.5, 5.1, 4.2, 2.4};
r = r.transposed(); // r == {1.5, 5.1, 2.4, 4.2}

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

См. также QSizeF::transposed().

QRectF QRectF::united(const QRectF &rectangle) const

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

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

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

qreal QRectF::width() const

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

См. также setWidth(), height() и size().

qreal QRectF::x() const

Возвращает x-координату левой границы прямоугольника. Эквивалентно left().

См. также setX(), y() и topLeft().

qreal QRectF::y() const

Возвращает y-координату верхней границы прямоугольника. Эквивалентно top().

См. также setY(), x() и topLeft().

QRectF QRectF::operator&(const QRectF &rectangle) const

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

См. также operator&=() и intersected().

QRectF &QRectF::operator&=(const QRectF &rectangle)

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

См. также intersected() и operator|=().

QRectF &QRectF::operator+=(const QMarginsF &margins)

Добавляет margins к прямоугольнику, расширяя его.

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

См. также marginsAdded(), marginsRemoved() и operator-=().

QRectF &QRectF::operator-=(const QMarginsF &margins)

Возвращает прямоугольник, уменьшенный на margins.

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

См. также marginsRemoved(), operator+=() и marginsAdded().

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

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

См. также united() и operator|=().

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

Объединяет этот прямоугольник с заданным rectangle.

См. также united() и operator|().