Класс 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. Размеры также можно получить по отдельности с помощью функций ширина() и высота(). Для изменения размеров используйте функции 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(const QRect &rectangle)

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

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

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

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

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

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

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

См. также 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, since 5.8] 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.

См. также 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().

[since 5.3] QRectF QRectF::marginsAdded(const QMarginsF &margins) const

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

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

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

[since 5.3] 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)

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

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

void QRectF::setWidth(qreal 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, основанный на значениях этого прямоугольника, являющийся наименьшим возможным целочисленным прямоугольником, который полностью содержит этот прямоугольник.

См. также 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

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

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

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

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

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

См. также 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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