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

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

Функция 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

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

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

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

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

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

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