Класс QRect

Класс QRect определяет прямоугольник в плоскости с использованием целочисленной точности. Подробнее...

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

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

Общедоступные функции

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

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

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

QRect может быть создан с набором целых чисел left, top, width и height, или из QPoint и QSize. Следующий код создаёт два идентичных прямоугольника.

QRect r1(100, 200, 11, 16);
QRect r2(QPoint(100, 200), QSize(11, 16));

Существует третий конструктор, который создаёт QRect с использованием координат верхнего левого и нижнего правого углов, но мы рекомендуем избегать его использования. Причина в том, что по историческим причинам значения, возвращаемые функциями bottom() и right(), отличаются от истинного нижнего правого угла прямоугольника.

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

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

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

intersected()	united()

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

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

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

Отрисовка

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

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

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

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

Координаты

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

Например, функции left(), setLeft() и moveLeft() в качестве примера: left() возвращает x-координату левого края прямоугольника, setLeft() устанавливает левый край прямоугольника в заданную x-координату (может изменить ширину, но никогда не изменит правый край прямоугольника), а moveLeft() перемещает весь прямоугольник по горизонтали, оставляя левый край прямоугольника в заданной x-координате и не изменяя его размер.

Обратите внимание, что по историческим причинам значения, возвращаемые функциями bottom() и right(), отличаются от истинного нижнего правого угла прямоугольника: функция right() возвращает left() + width() - 1, а функция bottom() возвращает top() + height() - 1. То же самое касается точки, возвращаемой вспомогательной функцией bottomRight(). Кроме того, x и y координаты функций topRight() и bottomLeft() соответственно содержат те же отклонения от истинных правого и нижнего краёв.

Мы рекомендуем использовать x() + width() и y() + height() для нахождения истинного нижнего правого угла и избегать right() и bottom(). Другое решение — использовать QRectF: класс QRectF определяет прямоугольник в плоскости, используя плавающую точку точность для координат, и функции QRectF::right() и QRectF::bottom() действительно возвращают координаты справа и снизу.

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

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

Ограничения

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

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

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

QRect::QRect(int x, int y, int width, int height)

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

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

QRect::QRect(const QPoint &topLeft, const QSize &size)

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

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

QRect::QRect(const QPoint &topLeft, const QPoint &bottomRight)

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

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

QRect::QRect()

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

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

void QRect::adjust(int dx1, int dy1, int dx2, int dy2)

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

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

QRect QRect::adjusted(int dx1, int dy1, int dx2, int dy2) const

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

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

int QRect::bottom() const

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

Обратите внимание, что по историческим причинам эта функция возвращает top() + height() - 1; используйте y() + height() для получения истинной y-координаты.

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

QPoint QRect::bottomLeft() const

Возвращает позицию левого нижнего угла прямоугольника. Обратите внимание, что по историческим причинам эта функция возвращает QPoint(left(), top() + height() - 1).

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

QPoint QRect::bottomRight() const

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

Обратите внимание, что по историческим причинам эта функция возвращает QPoint(left() + width() -1, top() + height() - 1).

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

QPoint QRect::center() const

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

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

bool QRect::contains(const QPoint &point, bool proper = false) const

Возвращает true если заданная point находится внутри или на границе прямоугольника, в противном случае возвращает false. Если proper равно true, эта функция возвращает true только если заданная point находится внутри прямоугольника (т.е. не на границе).

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

bool QRect::contains(const QRect &rectangle, bool proper = false) const

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

Возвращает true если заданный rectangle находится внутри этого прямоугольника, в противном случае возвращает false. Если proper равно true, эта функция возвращает true только если rectangle полностью находится внутри этого прямоугольника (не на границе).

bool QRect::contains(int x, int y) const

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

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

bool QRect::contains(int x, int y, bool proper) const

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

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

void QRect::getCoords(int *x1, int *y1, int *x2, int *y2) const

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

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

void QRect::getRect(int *x, int *y, int *width, int *height) const

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

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

int QRect::height() const

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

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

QRect QRect::intersected(const QRect &rectangle) const

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

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

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

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

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

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

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

bool QRect::isEmpty() const

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

Пустой прямоугольник имеет left() > right() или top() > bottom(). Пустой прямоугольник не является допустимым (т.е., isEmpty() == !isValid()).

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

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

bool QRect::isNull() const

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

Пустой прямоугольник имеет ширину и высоту, равную 0 (т.е., right() == left() - 1 и bottom() == top() - 1). Пустой прямоугольник также пуст и, следовательно, недействителен.

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

bool QRect::isValid() const

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

Допустимый прямоугольник имеет left() <= right() и top() <= bottom(). Обратите внимание, что такие нетривиальные операции, как пересечения, не определены для недопустимых прямоугольников. Допустимый прямоугольник не пуст (т.е., isValid() == !isEmpty()).

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

int QRect::left() const

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

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

QRect QRect::marginsAdded(const QMargins &margins) const

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

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

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

QRect QRect::marginsRemoved(const QMargins &margins) const

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

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

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

void QRect::moveBottom(int y)

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

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

void QRect::moveBottomLeft(const QPoint &position)

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

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

void QRect::moveBottomRight(const QPoint &position)

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

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

void QRect::moveCenter(const QPoint &position)

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

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

void QRect::moveLeft(int x)

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

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

void QRect::moveRight(int x)

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

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

void QRect::moveTo(int x, int y)

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

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

void QRect::moveTo(const QPoint &position)

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

void QRect::moveTop(int y)

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

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

void QRect::moveTopLeft(const QPoint &position)

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

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

void QRect::moveTopRight(const QPoint &position)

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

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

QRect QRect::normalized() const

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

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

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

int QRect::right() const

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

Обратите внимание, что по историческим причинам эта функция возвращает left() + width() - 1; используйте x() + width() для получения истинной координаты x.

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

void QRect::setBottom(int y)

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

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

void QRect::setBottomLeft(const QPoint &position)

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

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

void QRect::setBottomRight(const QPoint &position)

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

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

void QRect::setCoords(int x1, int y1, int x2, int y2)

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

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

void QRect::setHeight(int height)

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

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

void QRect::setLeft(int x)

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

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

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

void QRect::setRect(int x, int y, int width, int height)

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

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

void QRect::setRight(int x)

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

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

void QRect::setSize(const QSize &size)

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

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

void QRect::setTop(int y)

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

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

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

void QRect::setTopLeft(const QPoint &position)

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

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

void QRect::setTopRight(const QPoint &position)

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

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

void QRect::setWidth(int width)

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

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

void QRect::setX(int x)

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

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

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

void QRect::setY(int y)

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

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

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

QSize QRect::size() const

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

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

CGRect QRect::toCGRect() const

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

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

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

int QRect::top() const

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

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

QPoint QRect::topLeft() const

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

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

QPoint QRect::topRight() const

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

Обратите внимание, что по историческим причинам эта функция возвращает QPoint(left() + width() -1, top()).

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

void QRect::translate(int dx, int dy)

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

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

void QRect::translate(const QPoint &offset)

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

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

QRect QRect::translated(int dx, int dy) const

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

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

QRect QRect::translated(const QPoint &offset) const

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

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

QRect QRect::transposed() const

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

QRect r = {15, 51, 42, 24};
r = r.transposed(); // r == {15, 51, 24, 42}

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

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

QRect QRect::united(const QRect &rectangle) const

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

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

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

int QRect::width() const

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

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

int QRect::x() const

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

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

int QRect::y() const

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

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

QRect QRect::operator&(const QRect &rectangle) const

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

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

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

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

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

QRect &QRect::operator+=(const QMargins &margins)

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

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

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

QRect &QRect::operator-=(const QMargins &margins)

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

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

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

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

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

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

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

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

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