QRect Class

멤버 함수 설명서

[constexpr noexcept] QRect::QRect()

null 사각형을 생성합니다.

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 `가 true인 경우, 이 함수는 주어진 ` point `가 사각형 내부 (즉, 가장자리가 아닌 곳) 에 있을 때만 ` true `를 반환합니다.

intersects()도 참조하십시오 .

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

주어진 ` rectangle `가 이 사각형 내에 있으면 ` true `를 반환합니다. 그렇지 않으면 ` false`를 반환합니다. ` proper `가 true인 경우, 이 함수는 ` 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인 경우, 이 함수는 점이 사각형 내부에 완전히 위치해 있을 때(가장자리에 있지 않을 때)에만 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

사각형이 null 사각형인 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

null 사각형은 너비와 높이가 모두 0으로 설정된 사각형입니다(즉, right() == left() - 1이고, bottom() == top() - 1). null 사각형은 또한 비어 있으므로 유효하지 않습니다.

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

정규화된 사각형을 반환합니다. 즉, 너비와 높이가 모두 0이 아닌 사각형입니다.

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)

현재 위치를 기준으로 사각형을 x축 방향으로 dx, y축 방향으로 dy 만큼 이동시킵니다. 양수 값을 지정하면 사각형이 오른쪽과 아래쪽으로 이동합니다.

moveTopLeft(), moveTo(), translated()도 참조하십시오 .

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

사각형을 현재 위치 offset 를 기준으로 x축 방향으로x()만큼, y축 방향으로 offset 를 기준으로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|()도 참조하십시오 .