QRectF Class

멤버 함수 설명서

[constexpr noexcept] QRectF::QRectF()

null 사각형을 생성합니다.

isNull()도 참조하십시오 .

[constexpr noexcept] QRectF::QRectF(const QRect &rectangle)

주어진 QRect rectangle 를 사용하여 QRectF 사각형을 생성합니다.

toRect() 및 QRect::toRectF()도 참조하십시오 .

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)

주어진 topLeft 및 bottomRight 모서리를 사용하여 직사각형을 생성합니다.

setTopLeft() 및 setBottomRight()도 참조하십시오 .

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)

주어진 topLeft 모서리와 주어진 size 를 사용하여 직사각형을 생성합니다.

setTopLeft() 및 setSize()도 참조하십시오 .

[constexpr noexcept] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

(x, y)를 왼쪽 상단 모서리로 하고, 주어진 width 및 height 를 갖는 직사각형을 생성합니다. 모든 매개변수는 유한해야 합니다.

setRect()함수도 참조하십시오 .

[constexpr noexcept] void QRectF::adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2)

직사각형의 기존 좌표에 각각 dx1, dy1, dx2 및 dy2 를 추가합니다. 모든 매개변수는 유한한 값이어야 합니다.

adjusted() 및 setRect()도 참조하십시오 .

[constexpr noexcept] QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const

이 사각형의 기존 좌표에 각각 dx1, dy1, dx2 및 dy2 를 더한 새로운 사각형을 반환합니다. 모든 매개변수는 유한한 값이어야 합니다.

adjust()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::bottom() const

사각형의 하단 가장자리의 y 좌표를 반환합니다.

setBottom(), bottomLeft(), bottomRight()도 참조하십시오 .

[constexpr noexcept] QPointF QRectF::bottomLeft() const

사각형의 왼쪽 아래 모서리의 위치를 반환합니다.

setBottomLeft(), bottom(), left()도 참조하십시오 .

[constexpr noexcept] QPointF QRectF::bottomRight() const

사각형의 오른쪽 아래 모서리의 위치를 반환합니다.

setBottomRight(), bottom(), right()도 참조하십시오 .

[constexpr noexcept] QPointF QRectF::center() const

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

moveCenter()도 참조하십시오 .

[noexcept] bool QRectF::contains(const QPointF &point) const

주어진 점 point 이 사각형 내부나 가장자리에 있는 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

intersects()도 참조하십시오 .

[noexcept] bool QRectF::contains(const QRectF &rectangle) const

주어진 ` rectangle `가 이 직사각형 내에 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

[noexcept] bool QRectF::contains(qreal x, qreal y) const

점 (x, y)이 사각형 내부나 가장자리에 있을 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

[static noexcept] QRectF QRectF::fromCGRect(CGRect rect)

CGRect rect 를 기반으로 QRectF 를 생성합니다.

toCGRect()도 참조하십시오 .

[static, since 6.5] QRectF QRectF::fromDOMRect(emscripten::val domRect)

DOMRect(https://www.w3.org/TR/geometry-1/) domRect 를 QRectF 로 변환합니다. 제공된 매개변수가 DOMRect가 아닌 경우 동작이 정의되지 않습니다.

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

toDOMRect()도 참조하십시오 .

[constexpr] void QRectF::getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *y2) const

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

setCoords() 및 getRect()도 참조하십시오 .

[constexpr] void QRectF::getRect(qreal *x, qreal *y, qreal *width, qreal *height) const

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

setRect() 및 getCoords()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::height() const

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

setHeight(), width(), size()도 참조하십시오 .

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

이 사각형과 주어진 rectangle 의 교집합을 반환합니다. r.intersected(s) 는 r & s 와 동일하다는 점에 유의하십시오.

intersects(), united(), operator&=()도 참조하십시오 .

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

이 사각형이 주어진 rectangle 와 교차하는 경우(즉, 둘 사이에 비어 있지 않은 중첩 영역이 있는 경우) true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

교차 사각형은 intersected() 함수를 사용하여 가져올 수 있습니다.

contains()함수도 참조하십시오 .

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

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

빈 사각형은 width() <= 0이거나 height() <= 0인 경우입니다. 빈 사각형은 유효하지 않습니다(즉, isEmpty() == !isValid()).

normalized() 함수를 사용하여 모서리가 서로 바뀐 사각형을 가져올 수 있습니다.

isNull(), isValid(), normalized()도 참조하십시오 .

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

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

null 사각형은 너비와 높이가 모두 0으로 설정된 사각형입니다. 또한 null 사각형은 비어 있으므로 유효하지 않습니다.

isEmpty() 및 isValid()도 참조하십시오 .

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

사각형이 유효한 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

유효한 사각형은 width() > 0이고 height() > 0입니다. 교차와 같은 비사소 연산은 유효하지 않은 사각형에 대해서는 정의되지 않음을 유의하십시오. 유효한 사각형은 비어 있지 않습니다(즉, isValid() == !isEmpty()).

isNull(), isEmpty(), normalized()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::left() const

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

setLeft(), topLeft() 및 bottomLeft()도 참조하십시오 .

[constexpr noexcept] QRectF QRectF::marginsAdded(const QMarginsF &margins) const

margins 로 확장된 사각형을 반환합니다.

operator+=(), marginsRemoved(), operator-=()도 참조하십시오 .

[constexpr noexcept] QRectF QRectF::marginsRemoved(const QMarginsF &margins) const

사각형에서 ‘ margins ’를 제거하여 크기를 줄입니다.

marginsAdded(), operator+=(), operator-=()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveBottom(qreal y)

직사각형의 하단 가장자리를 지정된 유한 좌표 y 에 고정시킨 채, 직사각형을 수직 방향으로 이동시킵니다. 직사각형의 크기는 변하지 않습니다.

bottom(), setBottom() 및 moveTop()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveBottomLeft(const QPointF &position)

직사각형을 이동시키되, 왼쪽 하단 모서리는 지정된 좌표 position 에 그대로 유지합니다. 직사각형의 크기는 변하지 않습니다.

setBottomLeft(), moveBottom(), moveLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveBottomRight(const QPointF &position)

직사각형을 이동하여 오른쪽 하단 모서리가 지정된 position 에 위치하도록 합니다. 직사각형의 크기는 변하지 않습니다.

setBottomRight(), moveBottom(), moveRight()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveCenter(const QPointF &position)

주어진 좌표 position 에 중심점을 고정시킨 채 사각형을 이동합니다. 사각형의 크기는 변하지 않습니다.

center()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveLeft(qreal x)

직사각형의 왼쪽 가장자리를 지정된 유한 x 좌표에 고정시킨 채, 직사각형을 수평 방향으로 이동시킵니다. 직사각형의 크기는 변하지 않습니다.

left(), setLeft(), moveRight()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveRight(qreal x)

직사각형의 오른쪽 가장자리를 지정된 유한 좌표 x 에 위치시킨 채, 직사각형을 수평 방향으로 이동시킵니다. 직사각형의 크기는 변하지 않습니다.

right(), setRight(), moveLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveTo(qreal x, qreal y)

직사각형의 왼쪽 상단 모서리를 지정된 위치에 고정시킨 채로 직사각형을 이동합니다(x, y). 직사각형의 크기는 변하지 않습니다. 두 매개변수 모두 유한한 값이어야 합니다.

translate() 및 moveTopLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveTo(const QPointF &position)

직사각형을 이동시키되, 왼쪽 위 모서리는 지정된 좌표 position 에 그대로 유지합니다.

[constexpr noexcept] void QRectF::moveTop(qreal y)

직사각형의 상단 변을 지정된 유한 좌표 y 에 위치하도록 유지하면서 직사각형을 수직 방향으로 이동합니다. 직사각형의 크기는 변하지 않습니다.

top(), setTop(), moveBottom()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveTopLeft(const QPointF &position)

직사각형을 이동시키되, 왼쪽 상단 모서리는 지정된 좌표 position 에 그대로 유지합니다. 직사각형의 크기는 변하지 않습니다.

setTopLeft(), moveTop(), moveLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::moveTopRight(const QPointF &position)

직사각형을 이동시키되, 오른쪽 상단 모서리는 지정된 좌표 position 에 그대로 유지합니다. 직사각형의 크기는 변하지 않습니다.

setTopRight(), moveTop(), moveRight()도 참조하십시오 .

[noexcept] QRectF QRectF::normalized() const

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

width() < 0인 경우 이 함수는 왼쪽 모서리와 오른쪽 모서리의 위치를 바꾸며, height() < 0인 경우 위쪽 모서리와 아래쪽 모서리의 위치를 바꿉니다.

isValid() 및 isEmpty()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::right() const

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

setRight(), topRight(), bottomRight()도 참조하십시오 .

[constexpr noexcept] void QRectF::setBottom(qreal y)

직사각형의 하단 가장자리를 지정된 유한한 y 좌표로 설정합니다. 높이가 변경될 수 있지만, 직사각형의 상단 가장자리는 절대 변경되지 않습니다.

bottom() 및 moveBottom()도 참조하십시오 .

[constexpr noexcept] void QRectF::setBottomLeft(const QPointF &position)

사각형의 왼쪽 아래 모서리를 주어진 좌표 position 로 설정합니다. 크기는 변경될 수 있지만, 사각형의 오른쪽 위 모서리는 절대 변경되지 않습니다.

bottomLeft() 및 moveBottomLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::setBottomRight(const QPointF &position)

사각형의 오른쪽 아래 모서리를 주어진 좌표 position 에 맞춥니다. 크기는 변경될 수 있지만, 사각형의 왼쪽 위 모서리는 절대 변경되지 않습니다.

bottomRight() 및 moveBottomRight()도 참조하십시오 .

[constexpr noexcept] void QRectF::setCoords(qreal x1, qreal y1, qreal x2, qreal y2)

직사각형의 왼쪽 상단 모서리 좌표를 (x1, y1)로, 오른쪽 하단 모서리 좌표를 (x2, y2)로 설정합니다. 모든 매개변수는 유한한 값이어야 합니다.

getCoords() 및 setRect()도 참조하십시오 .

[constexpr noexcept] void QRectF::setHeight(qreal height)

사각형의 높이를 지정된 유한한 값 height 로 설정합니다. 하단 변은 변경되지만, 상단 변은 변경되지 않습니다.

height() 및 setSize()도 참조하십시오 .

[constexpr noexcept] void QRectF::setLeft(qreal x)

사각형의 왼쪽 가장자리를 주어진 유한한 x 좌표로 설정합니다. 너비가 변경될 수 있지만, 사각형의 오른쪽 가장자리는 절대 변경되지 않습니다.

setX()와 동일합니다.

left() 및 moveLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::setRect(qreal x, qreal y, qreal width, qreal height)

직사각형의 왼쪽 상단 모서리 좌표를 (x, y)로 설정하고, 크기를 주어진 width 및 height 로 설정합니다. 모든 매개변수는 유한한 값이어야 합니다.

getRect() 및 setCoords()도 참조하십시오 .

[constexpr noexcept] void QRectF::setRight(qreal x)

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

right() 및 moveRight()도 참조하십시오 .

[constexpr noexcept] void QRectF::setSize(const QSizeF &size)

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

size(), setWidth(), setHeight()도 참조하십시오 .

[constexpr noexcept] void QRectF::setTop(qreal y)

직사각형의 상단 가장자리를 지정된 유한한 y 좌표로 설정합니다. 높이가 변경될 수 있지만, 직사각형의 하단 가장자리는 절대 변경되지 않습니다.

setY()와 동일합니다.

top() 및 moveTop()도 참조하십시오 .

[constexpr noexcept] void QRectF::setTopLeft(const QPointF &position)

사각형의 왼쪽 상단 모서리를 지정된 좌표 position 로 설정합니다. 크기는 변경될 수 있지만, 사각형의 오른쪽 하단 모서리는 절대 변경되지 않습니다.

topLeft() 및 moveTopLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::setTopRight(const QPointF &position)

사각형의 오른쪽 상단 모서리를 주어진 좌표 position 로 설정합니다. 크기는 변경될 수 있지만, 사각형의 왼쪽 하단 모서리는 절대 변경되지 않습니다.

topRight() 및 moveTopRight()도 참조하십시오 .

[constexpr noexcept] void QRectF::setWidth(qreal width)

직사각형의 너비를 지정된 유한 값 width 로 설정합니다. 오른쪽 가장자리는 변경되지만, 왼쪽 가장자리는 변경되지 않습니다.

width() 및 setSize()도 참조하십시오 .

[constexpr noexcept] void QRectF::setX(qreal x)

사각형의 왼쪽 가장자리를 지정된 유한한 x 좌표로 설정합니다. 너비가 변경될 수 있지만, 사각형의 오른쪽 가장자리는 절대 변경되지 않습니다.

setLeft()와 동일합니다.

x(), setY(), setTopLeft()도 참조하십시오 .

[constexpr noexcept] void QRectF::setY(qreal y)

직사각형의 상단 가장자리를 지정된 유한한 y 좌표로 설정합니다. 높이가 변경될 수 있지만, 직사각형의 하단 가장자리는 절대 변경되지 않습니다.

setTop()와 동일합니다.

y(), setX(), setTopLeft()도 참조하십시오 .

[constexpr noexcept] QSizeF QRectF::size() const

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

setSize(), width(), height()도 참조하십시오 .

[noexcept] QRect QRectF::toAlignedRect() const

이 사각형의 값을 기반으로, 이 사각형을 완전히 포함하는 가장 작은 정수 사각형인 QRect 을 반환합니다.

toRect()도 참조하십시오 .

[noexcept] CGRect QRectF::toCGRect() const

QRectF 를 사용하여 CGRect를 생성합니다.

fromCGRect()도 참조하십시오 .

[since 6.5] emscripten::val QRectF::toDOMRect() const

이 객체를 DOMRect(https://www.w3.org/TR/geometry-1/)로 변환합니다.

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

fromDOMRect()도 참조하십시오 .

[constexpr noexcept] QRect QRectF::toRect() const

이 사각형의 값을 기반으로 QRect 객체를 반환합니다. 반환된 사각형의 좌표는 가장 가까운 정수로 반올림된다는 점에 유의하십시오.

QRectF(), toAlignedRect(), QRect::toRectF()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::top() const

사각형의 상단 가장자리의 y 좌표를 반환합니다. y()와 동일합니다.

setTop(), topLeft() 및 topRight()도 참조하십시오 .

[constexpr noexcept] QPointF QRectF::topLeft() const

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

setTopLeft(), top(), left()도 참조하십시오 .

[constexpr noexcept] QPointF QRectF::topRight() const

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

setTopRight(), top(), right()도 참조하십시오 .

[constexpr noexcept] void QRectF::translate(qreal dx, qreal dy)

현재 위치를 기준으로 직사각형을 x축 방향으로 dx 만큼, y축 방향으로 dy 만큼 이동시킵니다. 양수 값은 직사각형을 오른쪽과 아래쪽으로 이동시킵니다. 두 매개변수 모두 유한한 값이어야 합니다.

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

[constexpr noexcept] void QRectF::translate(const QPointF &offset)

사각형을 현재 위치에 상대적으로 x축 방향으로 offset.x()만큼, y축 방향으로 offset.y()만큼 이동시킵니다.

[constexpr noexcept] QRectF QRectF::translated(qreal dx, qreal dy) const

현재 위치를 기준으로 x축 방향으로 dx, y축 방향으로 dy 만큼 변위된 사각형의 복사본을 반환합니다. 양수 값일 경우 사각형이 오른쪽과 아래쪽으로 이동합니다. 두 매개변수 모두 유한한 값이어야 합니다.

translate()도 참조하십시오 .

[constexpr noexcept] QRectF QRectF::translated(const QPointF &offset) const

현재 위치를 기준으로 x축 방향으로는 offset.x()만큼, y축 방향으로는 offset.y()만큼 평행 이동된 사각형의 복사본을 반환합니다.

[constexpr noexcept] 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}

QSizeF::transposed()도 참조하십시오 .

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

이 사각형과 지정된 ` rectangle`의 외곽 사각형을 반환합니다.

intersected()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::width() const

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

setWidth(), height(), size()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::x() const

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

setX(), y() 및 topLeft()도 참조하십시오 .

[constexpr noexcept] qreal QRectF::y() const

사각형의 상단 가장자리의 y 좌표를 반환합니다. top()와 동일합니다.

setY(), x() 및 topLeft()도 참조하십시오 .

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

이 사각형과 주어진 rectangle 의 교차 영역을 반환합니다. 교차 영역이 없는 경우 빈 사각형을 반환합니다.

operator&=() 및 intersected()도 참조하십시오 .

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

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

intersected() 및 operator&()도 참조하십시오 .

[constexpr noexcept] QRectF &QRectF::operator+=(const QMarginsF &margins)

margins 를 사각형에 추가하여 크기를 늘립니다.

marginsAdded(), marginsRemoved(), operator-=()도 참조하십시오 .

[constexpr noexcept] QRectF &QRectF::operator-=(const QMarginsF &margins)

margins 에 따라 크기가 축소된 직사각형을 반환합니다.

marginsRemoved(), operator+=(), marginsAdded()도 참조하십시오 .

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

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

united() 및 operator|=()도 참조하십시오 .

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

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

united() 및 operator|()도 참조하십시오 .