QRect Class

멤버 함수 문서

[constexpr noexcept] QRect::QRect()

널 사각형을 만듭니다.

isNull()도 참조하세요 .

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QPoint &bottomRight)

주어진 topLeft 및 bottomRight 모서리가 모두 포함된 직사각형을 만듭니다.

bottomRight 이 topLeft 보다 높고 왼쪽에 있는 경우 정의된 직사각형은 모서리를 포함하지 않습니다.

setTopLeft(), setBottomRight() 및 span()도 참조하세요 .

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QSize &size)

주어진 topLeft 모서리와 주어진 size 로 직사각형을 만듭니다.

setTopLeft() 및 setSize()도 참조하세요 .

[constexpr noexcept] QRect::QRect(int x, int y, int width, int height)

(x, y)을 왼쪽 상단 모서리로 하고 지정된 width 및 height 을 사용하여 직사각형을 구성합니다.

setRect()도 참조하세요 .

[constexpr noexcept] void QRect::adjust(int dx1, int dy1, int dx2, int dy2)

직사각형의 기존 좌표에 각각 dx1, dy1, dx2 및 dy2 을 추가합니다.

adjusted() 및 setRect()도 참조하세요 .

[constexpr noexcept] QRect QRect::adjusted(int dx1, int dy1, int dx2, int dy2) const

이 직사각형의 기존 좌표에 각각 dx1, dy1, dx2 및 dy2 이 추가된 새 직사각형을 반환합니다.

adjust()도 참조하세요 .

[constexpr noexcept] int QRect::bottom() const

직사각형의 아래쪽 가장자리의 y 좌표를 반환합니다.

이 함수는 top() + height() - 1을 반환하며, 실제 y 좌표를 검색하려면 y() + height()를 사용합니다.

setBottom(), bottomLeft() 및 bottomRight()도 참조하세요 .

[constexpr noexcept] QPoint QRect::bottomLeft() const

직사각형의 왼쪽 하단 모서리 위치를 반환합니다. 역사적으로 이 함수는 QPoint(left(), top() + height() - 1)을 반환합니다.

setBottomLeft(), bottom() 및 left()도 참조하세요 .

[constexpr noexcept] QPoint QRect::bottomRight() const

직사각형의 오른쪽 하단 모서리 위치를 반환합니다.

역사적으로 이 함수는 QPoint(left() + width() -1, top() + height() - 1)을 반환합니다.

setBottomRight(), bottom() 및 right()도 참조하세요 .

[constexpr noexcept] QPoint QRect::center() const

직사각형의 중심점을 반환합니다.

moveCenter()도 참조하세요 .

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

주어진 point 이 직사각형의 내부 또는 가장자리에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. proper 이 참이면 이 함수는 주어진 point 이 직사각형 내부 (즉, 가장자리가 아닌)에 있는 경우에만 true 을 반환합니다.

intersects()도 참조하세요 .

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

이 함수는 오버로드된 함수입니다.

주어진 rectangle 이 이 사각형 안에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. proper 이 참이면 이 함수는 rectangle 이 이 사각형 안쪽(가장자리가 아닌)에 완전히 있는 경우에만 true 을 반환합니다.

[noexcept] bool QRect::contains(int x, int y) const

이 함수는 오버로드된 함수입니다.

점(x, y)이 이 직사각형 안에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

이 함수는 오버로드된 함수입니다.

점(x, y)이 직사각형의 내부 또는 가장자리에 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. proper 이 참이면 이 함수는 점이 직사각형 안쪽(가장자리가 아닌)에 완전히 있는 경우에만 true 을 반환합니다.

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

직사각형의 왼쪽 상단 모서리 위치를 *x1 및 *y1 으로, 오른쪽 하단 모서리 위치를 *x2 및 *y2 으로 추출합니다.

setCoords() 및 getRect()도 참조하세요 .

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

직사각형의 왼쪽 상단 모서리 위치를 *x 및 *y 으로, 크기를 *width 및 *height 으로 추출합니다.

setRect() 및 getCoords()도 참조하세요 .

[constexpr noexcept] int QRect::height() const

직사각형의 높이를 반환합니다.

setHeight(), width() 및 size()도 참조하세요 .

[noexcept] QRect QRect::intersected(const QRect &rectangle) const

이 사각형과 주어진 rectangle 의 교집합을 반환합니다. r.intersected(s) 은 r & s 과 동일합니다.

intersects(), united(), operator&=()도 참조하세요 .

[noexcept] bool QRect::intersects(const QRect &rectangle) const

이 사각형이 주어진 rectangle 과 교차하는 경우(즉, 두 사각형 내에 픽셀이 하나 이상 있는 경우) true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

교차 사각형은 intersected() 함수를 사용하여 검색할 수 있습니다.

contains()도 참조하세요 .

[constexpr noexcept] bool QRect::isEmpty() const

사각형이 비어 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

빈 사각형에는 left() > right() 또는 top() > bottom()이 있습니다. 빈 사각형은 유효하지 않습니다(즉, isEmpty() == !isValid()).

모서리가 바뀐 직사각형을 검색하려면 normalized() 함수를 사용합니다.

isNull(), isValid() 및 normalized()도 참조하세요 .

[constexpr noexcept] bool QRect::isNull() const

사각형이 널 사각형이면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

널 사각형은 너비와 높이가 모두 0으로 설정되어 있습니다(예: right() == left() - 1 및 bottom() == top() - 1). 널 사각형도 비어 있으므로 유효하지 않습니다.

isEmpty() 및 isValid()도 참조하세요 .

[constexpr noexcept] bool QRect::isValid() const

사각형이 유효하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

유효한 사각형은 left() <= right() 및 top() <= bottom()를 갖습니다. 유효하지 않은 사각형에는 교집합과 같은 사소한 연산이 정의되어 있지 않다는 점에 유의하세요. 유효한 사각형은 비어 있지 않습니다(즉, isValid() == !isEmpty()).

isNull(), isEmpty() 및 normalized()도 참조하세요 .

[constexpr noexcept] int QRect::left() const

직사각형의 왼쪽 가장자리의 x 좌표를 반환합니다. x ()와 동일합니다.

setLeft(), topLeft() 및 bottomLeft()도 참조하세요 .

[constexpr noexcept] QRect QRect::marginsAdded(const QMargins &margins) const

margins 에 의해 커진 직사각형을 반환합니다.

operator+=(), marginsRemoved(), operator-=()도 참조하세요 .

[constexpr noexcept] QRect QRect::marginsRemoved(const QMargins &margins) const

직사각형에서 margins 을 제거하여 축소합니다.

marginsAdded(), operator+=() 및 operator-=()도 참조하세요 .

[constexpr noexcept] void QRect::moveBottom(int y)

직사각형을 수직으로 이동하여 직사각형의 아래쪽 가장자리를 지정된 y 좌표에 남깁니다. 직사각형의 크기는 변경되지 않습니다.

bottom(), setBottom() 및 moveTop()도 참조하세요 .

[constexpr noexcept] void QRect::moveBottomLeft(const QPoint &position)

직사각형을 이동하여 왼쪽 하단 모서리를 지정된 position 에 남깁니다. 사각형의 크기는 변경되지 않습니다.

setBottomLeft(), moveBottom() 및 moveLeft()도 참조하세요 .

[constexpr noexcept] void QRect::moveBottomRight(const QPoint &position)

직사각형을 이동하여 오른쪽 하단 모서리를 지정된 position 에 남깁니다. 사각형의 크기는 변경되지 않습니다.

setBottomRight(), moveRight() 및 moveBottom()도 참조하세요 .

[constexpr noexcept] void QRect::moveCenter(const QPoint &position)

주어진 position 에 중심점을 두고 직사각형을 이동합니다. 직사각형의 크기는 변경되지 않습니다.

center()도 참조하세요 .

[constexpr noexcept] void QRect::moveLeft(int x)

직사각형의 왼쪽 가장자리를 지정된 x 좌표에 두고 직사각형을 수평으로 이동합니다. 직사각형의 크기는 변경되지 않습니다.

left(), setLeft() 및 moveRight()도 참조하세요 .

[constexpr noexcept] void QRect::moveRight(int x)

직사각형을 수평으로 이동하여 직사각형의 오른쪽 가장자리를 지정된 x 좌표에 남깁니다. 직사각형의 크기는 변경되지 않습니다.

right(), setRight() 및 moveLeft()도 참조하세요 .

[constexpr noexcept] void QRect::moveTo(const QPoint &position)

직사각형을 이동하여 왼쪽 상단 모서리를 지정된 position 에 남깁니다.

[constexpr noexcept] void QRect::moveTo(int x, int y)

직사각형을 이동하여 왼쪽 상단 모서리를 지정된 위치(x, y)에 남깁니다. 사각형의 크기는 변경되지 않습니다.

translate() 및 moveTopLeft()도 참조하세요 .

[constexpr noexcept] void QRect::moveTop(int y)

직사각형을 수직으로 이동하여 직사각형의 위쪽 가장자리를 지정된 y 좌표에 남깁니다. 직사각형의 크기는 변경되지 않습니다.

top(), setTop() 및 moveBottom()도 참조하세요 .

[constexpr noexcept] void QRect::moveTopLeft(const QPoint &position)

직사각형을 이동하여 왼쪽 상단 모서리를 지정된 position 에 남깁니다. 사각형의 크기는 변경되지 않습니다.

setTopLeft(), moveTop() 및 moveLeft()도 참조하세요 .

[constexpr noexcept] void QRect::moveTopRight(const QPoint &position)

직사각형을 이동하여 오른쪽 상단 모서리를 지정된 position 에 남깁니다. 사각형의 크기는 변경되지 않습니다.

setTopRight(), moveTop() 및 moveRight()도 참조하세요 .

[noexcept] QRect QRect::normalized() const

정규화된 직사각형, 즉 너비와 높이가 음수가 아닌 직사각형을 반환합니다.

width() < 0이면 왼쪽과 오른쪽 모서리를 바꾸고 height() < 0이면 위쪽과 아래쪽 모서리를 바꿉니다. 모서리는 동시에 비포함에서 포함으로 변경됩니다.

isValid() 및 isEmpty()도 참조하세요 .

[constexpr noexcept] int QRect::right() const

직사각형의 오른쪽 가장자리의 x 좌표를 반환합니다.

이 함수는 left() + width() - 1을 반환하며, 실제 x 좌표를 검색하려면 x() + width()을 사용합니다.

setRight(), topRight() 및 bottomRight()도 참조하세요 .

[constexpr noexcept] void QRect::setBottom(int y)

직사각형의 아래쪽 가장자리를 지정된 y 좌표로 설정합니다. 높이는 변경할 수 있지만 직사각형의 위쪽 가장자리는 변경하지 않습니다.

bottom() 및 moveBottom()도 참조하세요 .

[constexpr noexcept] void QRect::setBottomLeft(const QPoint &position)

직사각형의 왼쪽 하단 모서리를 지정된 position 으로 설정합니다. 크기는 변경할 수 있지만 직사각형의 오른쪽 상단 모서리는 변경하지 않습니다.

bottomLeft() 및 moveBottomLeft()도 참조하세요 .

[constexpr noexcept] void QRect::setBottomRight(const QPoint &position)

직사각형의 오른쪽 하단 모서리를 지정된 position 으로 설정합니다. 크기는 변경할 수 있지만 직사각형의 왼쪽 상단 모서리는 변경하지 않습니다.

bottomRight() 및 moveBottomRight()도 참조하세요 .

[constexpr noexcept] void QRect::setCoords(int x1, int y1, int x2, int y2)

직사각형의 왼쪽 상단 모서리 좌표를 (x1, y1)로, 오른쪽 하단 모서리 좌표를 (x2, y2)로 설정합니다.

getCoords() 및 setRect()도 참조하세요 .

[constexpr noexcept] void QRect::setHeight(int height)

직사각형의 높이를 주어진 height 으로 설정합니다. 아래쪽 가장자리는 변경되지만 위쪽 가장자리는 변경되지 않습니다.

height() 및 setSize()도 참조하세요 .

[constexpr noexcept] void QRect::setLeft(int x)

직사각형의 왼쪽 가장자리를 지정된 x 좌표로 설정합니다. 너비는 변경할 수 있지만 직사각형의 오른쪽 가장자리는 변경하지 않습니다.

setX()와 동일합니다.

left() 및 moveLeft()도 참조하세요 .

[constexpr noexcept] void QRect::setRect(int x, int y, int width, int height)

직사각형의 왼쪽 상단 모서리 좌표를 (x, y)로, 크기를 지정된 width 및 height 로 설정합니다.

getRect() 및 setCoords()도 참조하세요 .

[constexpr noexcept] void QRect::setRight(int x)

직사각형의 오른쪽 가장자리를 지정된 x 좌표로 설정합니다. 너비는 변경할 수 있지만 직사각형의 왼쪽 가장자리는 변경하지 않습니다.

right() 및 moveRight()도 참조하세요 .

[constexpr noexcept] void QRect::setSize(const QSize &size)

직사각형의 크기를 지정된 size 으로 설정합니다. 왼쪽 상단 모서리는 이동되지 않습니다.

size(), setWidth() 및 setHeight()도 참조하세요 .

[constexpr noexcept] void QRect::setTop(int y)

직사각형의 위쪽 가장자리를 지정된 y 좌표로 설정합니다. 높이는 변경할 수 있지만 직사각형의 아래쪽 가장자리는 변경하지 않습니다.

setY()와 동일합니다.

top() 및 moveTop()도 참조하세요 .

[constexpr noexcept] void QRect::setTopLeft(const QPoint &position)

직사각형의 왼쪽 상단 모서리를 지정된 position 으로 설정합니다. 크기는 변경할 수 있지만 직사각형의 오른쪽 하단 모서리는 변경하지 않습니다.

topLeft() 및 moveTopLeft()도 참조하세요 .

[constexpr noexcept] void QRect::setTopRight(const QPoint &position)

직사각형의 오른쪽 상단 모서리를 지정된 position 으로 설정합니다. 크기는 변경할 수 있지만 직사각형의 왼쪽 하단 모서리는 변경하지 않습니다.

topRight() 및 moveTopRight()도 참조하세요 .

[constexpr noexcept] void QRect::setWidth(int width)

직사각형의 너비를 주어진 width 으로 설정합니다. 오른쪽 가장자리는 변경되지만 왼쪽 가장자리는 변경되지 않습니다.

width() 및 setSize()도 참조하세요 .

[constexpr noexcept] void QRect::setX(int x)

직사각형의 왼쪽 가장자리를 지정된 x 좌표로 설정합니다. 너비는 변경할 수 있지만 직사각형의 오른쪽 가장자리는 변경하지 않습니다.

setLeft()와 동일합니다.

x(), setY() 및 setTopLeft()도 참조하세요 .

[constexpr noexcept] void QRect::setY(int y)

직사각형의 위쪽 가장자리를 지정된 y 좌표로 설정합니다. 높이는 변경할 수 있지만 직사각형의 아래쪽 가장자리는 변경하지 않습니다.

setTop()와 동일합니다.

y(), setX() 및 setTopLeft()도 참조하세요 .

[constexpr noexcept] QSize QRect::size() const

직사각형의 크기를 반환합니다.

setSize(), width() 및 height()도 참조하세요 .

[static constexpr noexcept, since 6.0] QRect QRect::span(const QPoint &p1, const QPoint &p2)

p1 과 p2 두 점과 그 사이의 모든 점을 포함하는 직사각형을 반환합니다.

이 함수는 Qt 6.0에 도입되었습니다.

[noexcept] CGRect QRect::toCGRect() const

QRect 에서 CGRect를 생성합니다.

QRectF::fromCGRect()도 참조하세요 .

[constexpr noexcept, since 6.4] QRectF QRect::toRectF() const

이 직사각형을 부동소수점 정확도를 가진 직사각형으로 반환합니다.

이 함수는 Qt 6.4에 도입되었습니다.

QRectF::toRect()도 참조하십시오 .

[constexpr noexcept] int QRect::top() const

직사각형의 위쪽 가장자리의 y 좌표를 반환합니다. y ()에 해당합니다.

setTop(), topLeft() 및 topRight()도 참조하세요 .

[constexpr noexcept] QPoint QRect::topLeft() const

직사각형의 왼쪽 상단 모서리 위치를 반환합니다.

setTopLeft(), top() 및 left()도 참조하세요 .

[constexpr noexcept] QPoint QRect::topRight() const

직사각형의 오른쪽 상단 모서리 위치를 반환합니다.

역사적으로 이 함수는 QPoint(left() + width() -1, top())를 반환합니다.

setTopRight(), top() 및 right()도 참조하세요 .

[constexpr noexcept] void QRect::translate(int dx, int dy)

현재 위치를 기준으로 직사각형 dx 을 x축을 따라, dy 을 y축을 따라 이동합니다. 양수 값은 직사각형을 오른쪽 및 아래로 이동합니다.

moveTopLeft(), moveTo() 및 translated()도 참조하세요 .

[constexpr noexcept] void QRect::translate(const QPoint &offset)

이 함수는 오버로드된 함수입니다.

직사각형 offset.x()을 현재 위치를 기준으로 x축을 따라 이동하고 offset.y()을 y축을 따라 이동합니다.

[constexpr noexcept] QRect QRect::translated(int dx, int dy) const

현재 위치를 기준으로 x축을 따라 dx, y축을 따라 dy 변환된 직사각형의 복사본을 반환합니다. 양수 값은 직사각형을 오른쪽과 아래로 이동시킵니다.

translate()도 참조하세요 .

[constexpr noexcept] QRect QRect::translated(const QPoint &offset) const

이 함수는 오버로드된 함수입니다.

현재 위치를 기준으로 x축을 따라 offset.x(), y축을 따라 offset.y() 변환된 직사각형의 복사본을 반환합니다.

[constexpr noexcept] QRect QRect::transposed() const

너비와 높이가 교환된 직사각형의 복사본을 반환합니다:

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

QSize::transposed()도 참조하세요 .

[noexcept] QRect QRect::united(const QRect &rectangle) const

이 사각형과 주어진 rectangle 의 경계 사각형을 반환합니다.

intersected()도 참조하세요 .

[constexpr noexcept] int QRect::width() const

직사각형의 너비를 반환합니다.

setWidth(), height() 및 size()도 참조하세요 .

[constexpr noexcept] int QRect::x() const

직사각형의 왼쪽 가장자리의 x 좌표를 반환합니다. left ()와 동일합니다.

setX(), y() 및 topLeft()도 참조하세요 .

[constexpr noexcept] int QRect::y() const

직사각형의 위쪽 가장자리의 y 좌표를 반환합니다. top ()에 해당합니다.

setY(), x() 및 topLeft()도 참조하세요 .

[noexcept] QRect QRect::operator&(const QRect &rectangle) const

이 사각형과 주어진 rectangle 의 교집합을 반환합니다. 교집합이 없으면 빈 사각형을 반환합니다.

operator&=() 및 intersected()도 참조하세요 .

[noexcept] QRect &QRect::operator&=(const QRect &rectangle)

이 직사각형을 주어진 rectangle 과 교차시킵니다.

intersected() 및 operator&()도 참조하세요 .

[constexpr noexcept] QRect &QRect::operator+=(const QMargins &margins)

사각형에 margins 을 추가하여 사각형이 커집니다.

marginsAdded(), marginsRemoved() 및 operator-=()도 참조하세요 .

[constexpr noexcept] QRect &QRect::operator-=(const QMargins &margins)

margins 만큼 축소된 직사각형을 반환합니다.

marginsRemoved(), operator+=(), marginsAdded()도 참조하세요 .

[noexcept] QRect QRect::operator|(const QRect &rectangle) const

이 사각형과 주어진 rectangle 의 경계 사각형을 반환합니다.

operator|=() 및 united()도 참조하세요 .

[noexcept] QRect &QRect::operator|=(const QRect &rectangle)

이 직사각형을 주어진 rectangle 과 결합합니다.

united() 및 operator|()도 참조하세요 .