Класс 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(), которая возвращает прямоугольник, охватывающий данный прямоугольник и этот:

пересечение()	объединение()

Функция 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(const QRect &прямоугольник)

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

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

QRectF::QRectF(qreal x, qreal y, qreal ширина, qreal высота)

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

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

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

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

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

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

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

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

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

QRectF::QRectF()

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

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

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

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

Эта функция была добавлена в 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|().