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

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

Функция 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 width, qreal height)

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

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