QSizeF Class
QSizeF 클래스는 부동 소수점 정밀도를 사용하여 2차원 개체의 크기를 정의합니다. 더 보기...
Header: | #include <QSizeF> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake: | QT += core |
- 상속된 멤버를 포함한 모든 멤버 목록
- QSizeF는 페인팅 클래스의 일부입니다.
공용 함수
QSizeF() | |
QSizeF(const QSize &size) | |
QSizeF(qreal width, qreal height) | |
QSizeF | boundedTo(const QSizeF &otherSize) const |
QSizeF | expandedTo(const QSizeF &otherSize) const |
QSizeF | grownBy(QMarginsF margins) const |
qreal | height() const |
bool | isEmpty() const |
bool | isNull() const |
bool | isValid() const |
qreal & | rheight() |
qreal & | rwidth() |
void | scale(qreal width, qreal height, Qt::AspectRatioMode mode) |
void | scale(const QSizeF &size, Qt::AspectRatioMode mode) |
QSizeF | scaled(qreal width, qreal height, Qt::AspectRatioMode mode) const |
QSizeF | scaled(const QSizeF &s, Qt::AspectRatioMode mode) const |
void | setHeight(qreal height) |
void | setWidth(qreal width) |
QSizeF | shrunkBy(QMarginsF margins) const |
CGSize | toCGSize() const |
QSize | toSize() const |
void | transpose() |
QSizeF | transposed() const |
qreal | width() const |
QSizeF & | operator*=(qreal factor) |
QSizeF & | operator+=(const QSizeF &size) |
QSizeF & | operator-=(const QSizeF &size) |
QSizeF & | operator/=(qreal divisor) |
정적 공용 멤버
QSizeF | fromCGSize(CGSize size) |
관련 비회원
(since 6.8) bool | qFuzzyCompare(const QSizeF &lhs, const QSizeF &rhs) |
(since 6.8) bool | qFuzzyIsNull(const QSizeF &size) |
bool | operator!=(const QSizeF &lhs, const QSizeF &rhs) |
QSizeF | operator*(const QSizeF &size, qreal factor) |
QSizeF | operator*(qreal factor, const QSizeF &size) |
QSizeF | operator+(const QSizeF &s1, const QSizeF &s2) |
QSizeF | operator-(const QSizeF &s1, const QSizeF &s2) |
QSizeF | operator/(const QSizeF &size, qreal divisor) |
QDataStream & | operator<<(QDataStream &stream, const QSizeF &size) |
bool | operator==(const QSizeF &lhs, const QSizeF &rhs) |
QDataStream & | operator>>(QDataStream &stream, QSizeF &size) |
상세 설명
크기는 width() 및 height()로 지정됩니다. 생성자에서 설정하고 setWidth(), setHeight() 또는 scale() 함수를 사용하거나 산술 연산자를 사용하여 변경할 수 있습니다. rwidth () 및 rheight() 함수를 사용하여 너비와 높이에 대한 참조를 검색하여 크기를 직접 조작할 수도 있습니다. 마지막으로 transpose() 함수를 사용하여 너비와 높이를 바꿀 수 있습니다.
isValid() 함수는 크기가 유효한지 여부를 결정합니다. 유효한 크기는 너비와 높이가 모두 0보다 크거나 같아야 합니다. isEmpty () 함수는 너비와 높이 중 하나라도 0보다 작거나 같으면 true
을 반환하고, isNull() 함수는 너비와 높이가 모두 0인 경우에만 true
을 반환합니다.
expandedTo() 함수를 사용하여 이 크기와 주어진 크기의 최대 높이와 너비를 가진 크기를 검색합니다. 마찬가지로 boundedTo() 함수는 이 크기와 주어진 크기의 최소 높이와 너비를 포함하는 크기를 반환합니다.
QSizeF 클래스는 또한 너비와 높이를 가장 가까운 정수로 반올림하여 이 크기의 QSize 복사본을 반환하는 toSize() 함수도 제공합니다.
QSizeF 객체는 비교뿐만 아니라 스트리밍도 가능합니다.
QSize, QPointF, QRectF 를참조하세요 .
멤버 함수 문서
[constexpr noexcept]
QSizeF QSizeF::grownBy(QMarginsF margins) const
이 크기를 늘린 결과 크기를 반환합니다 margins.
shrunkBy()도 참조하세요 .
[constexpr noexcept]
QSizeF QSizeF::shrunkBy(QMarginsF margins) const
이 크기를 margins 만큼 줄인 크기를 반환합니다.
grownBy()도 참조하세요 .
[constexpr noexcept]
QSizeF::QSizeF()
잘못된 크기를 구성합니다.
isValid()도 참조하세요 .
[constexpr noexcept]
QSizeF::QSizeF(const QSize &size)
주어진 size 에서 부동소수점 정확도로 크기를 구축합니다.
toSize() 및 QSize::toSizeF()도 참조하세요 .
[constexpr noexcept]
QSizeF::QSizeF(qreal width, qreal height)
주어진 유한 width 과 height 로 크기를 구성합니다.
[constexpr noexcept]
QSizeF QSizeF::boundedTo(const QSizeF &otherSize) const
이 크기와 주어진 otherSize 의 최소 너비와 높이를 가진 크기를 반환합니다.
expandedTo() 및 scale()도 참조하세요 .
[constexpr noexcept]
QSizeF QSizeF::expandedTo(const QSizeF &otherSize) const
이 크기와 주어진 otherSize 의 최대 너비와 높이를 가진 크기를 반환합니다.
boundedTo() 및 scale()도 참조하세요 .
[static noexcept]
QSizeF QSizeF::fromCGSize(CGSize size)
size 에서 QRectF 을 만듭니다.
toCGSize()도 참조하세요 .
[constexpr noexcept]
qreal QSizeF::height() const
높이를 반환합니다.
width() 및 setHeight()도 참조하세요 .
[constexpr noexcept]
bool QSizeF::isEmpty() const
너비와 높이 중 하나라도 0보다 작거나 같으면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
[noexcept]
bool QSizeF::isNull() const
너비와 높이가 모두 0.0(부호 무시)이면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
isValid() 및 isEmpty()도 참조하세요 .
[constexpr noexcept]
bool QSizeF::isValid() const
너비와 높이가 모두 0보다 크면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
[constexpr noexcept]
qreal &QSizeF::rheight()
높이에 대한 참조를 반환합니다.
참조를 사용하면 높이를 직접 조작할 수 있습니다. 예를 들어
QSizeF size(100, 10.2); size.rheight() += 5.5; // size becomes (100,15.7)
rwidth() 및 setHeight()도 참조하세요 .
[constexpr noexcept]
qreal &QSizeF::rwidth()
너비에 대한 참조를 반환합니다.
참조를 사용하면 너비를 직접 조작할 수 있습니다. 예를 들어
QSizeF size(100.3, 10); size.rwidth() += 20.5; // size becomes (120.8,10)
rheight() 및 setWidth()도 참조하세요 .
[noexcept]
void QSizeF::scale(qreal width, qreal height, Qt::AspectRatioMode mode)
지정된 mode 에 따라 지정된 width 및 height 을 사용하여 직사각형으로 크기를 조정합니다.
- mode 가 Qt::IgnoreAspectRatio 인 경우 크기는 (width, height)로 설정됩니다.
- mode 가 Qt::KeepAspectRatio 인 경우 현재 크기는 가로 세로 비율을 유지하면서 (width, height) 내부의 가능한 한 큰 직사각형으로 조정됩니다.
- mode 이 Qt::KeepAspectRatioByExpanding 인 경우 현재 크기는 가로 세로 비율을 유지하면서 외부 (width, height)에서 가능한 한 작은 직사각형으로 조정됩니다.
예시:
QSizeF t1(10, 12); t1.scale(60, 60, Qt::IgnoreAspectRatio); // t1 is (60, 60) QSizeF t2(10, 12); t2.scale(60, 60, Qt::KeepAspectRatio); // t2 is (50, 60) QSizeF t3(10, 12); t3.scale(60, 60, Qt::KeepAspectRatioByExpanding); // t3 is (60, 72)
setWidth(), setHeight() 및 scaled()도 참조하세요 .
[noexcept]
void QSizeF::scale(const QSizeF &size, Qt::AspectRatioMode mode)
이 함수는 오버로드된 함수입니다.
지정된 mode 에 따라 지정된 size 의 직사각형으로 크기를 조정합니다.
[noexcept]
QSizeF QSizeF::scaled(qreal width, qreal height, Qt::AspectRatioMode mode) const
지정된 mode 에 따라 지정된 width 및 height 을 사용하여 직사각형으로 스케일링된 크기를 반환합니다.
scale()도 참조하세요 .
[noexcept]
QSizeF QSizeF::scaled(const QSizeF &s, Qt::AspectRatioMode mode) const
이 함수는 오버로드된 함수입니다.
지정된 mode 에 따라 지정된 크기 s 의 직사각형으로 스케일링된 크기를 반환합니다.
[constexpr noexcept]
void QSizeF::setHeight(qreal height)
높이를 주어진 유한값 height 으로 설정합니다.
height(), rheight(), setWidth()도 참조하세요 .
[constexpr noexcept]
void QSizeF::setWidth(qreal width)
너비를 주어진 유한값 width 으로 설정합니다.
width(), rwidth(), setHeight()도 참조하세요 .
[noexcept]
CGSize QSizeF::toCGSize() const
QSizeF 에서 CGSize를 생성합니다.
fromCGSize()도 참조하세요 .
[constexpr noexcept]
QSize QSizeF::toSize() const
이 크기의 정수 기반 복사본을 반환합니다.
반환된 크기의 좌표는 가장 가까운 정수로 반올림됩니다.
QSizeF() 및 QSize::toSizeF()도 참조하세요 .
[noexcept]
void QSizeF::transpose()
너비와 높이 값을 바꿉니다.
setWidth(), setHeight() 및 transposed()도 참조하세요 .
[constexpr noexcept]
QSizeF QSizeF::transposed() const
너비와 높이 값이 바뀐 크기를 반환합니다.
transpose()도 참조하세요 .
[constexpr noexcept]
qreal QSizeF::width() const
너비를 반환합니다.
height() 및 setWidth()도 참조하세요 .
[constexpr noexcept]
QSizeF &QSizeF::operator*=(qreal factor)
이 함수는 오버로드된 함수입니다.
너비와 높이를 모두 주어진 유한 factor 에 곱하고 크기에 대한 참조를 반환합니다.
scale()도 참조하세요 .
[constexpr noexcept]
QSizeF &QSizeF::operator+=(const QSizeF &size)
주어진 size 을 이 크기에 추가하고 이 크기에 대한 참조를 반환합니다. 예를 들어
[constexpr noexcept]
QSizeF &QSizeF::operator-=(const QSizeF &size)
이 크기에서 주어진 size 을 빼고 이 크기에 대한 참조를 반환합니다. 예를 들어
QSizeF &QSizeF::operator/=(qreal divisor)
이 함수는 오버로드된 함수입니다.
너비와 높이를 모두 주어진 divisor 으로 나누고 크기에 대한 참조를 반환합니다. divisor 은 0이나 NaN이 아니어야 합니다.
scale()도 참조하세요 .
관련 비회원
[constexpr noexcept, since 6.8]
bool qFuzzyCompare(const QSizeF &lhs, const QSizeF &rhs)
크기 lhs 가 크기 rhs 와 거의 같으면 true
를 반환하고, 그렇지 않으면 false
를 반환합니다.
폭과 높이가 거의 같으면 크기가 거의 같은 것으로 간주합니다.
이 함수는 Qt 6.8에 도입되었습니다.
[constexpr noexcept, since 6.8]
bool qFuzzyIsNull(const QSizeF &size)
size 크기의 너비와 높이가 모두 0과 같으면 true
을 반환합니다.
이 함수는 Qt 6.8에 도입되었습니다.
[constexpr noexcept]
bool operator!=(const QSizeF &lhs, const QSizeF &rhs)
lhs 과 rhs 이 충분히 다르면 true
을 반환하고, 그렇지 않으면 false
을 반환합니다.
경고: 이 함수는 엄격한 부등식을 검사하지 않고 대신 퍼지 비교를 사용하여 크기의 범위를 비교합니다.
[constexpr noexcept]
QSizeF operator*(const QSizeF &size, qreal factor)
이 함수는 오버로드된 함수입니다.
주어진 size 에 주어진 유한 factor 을 곱한 후 결과를 반환합니다.
QSizeF::scale()도 참조하세요 .
[constexpr noexcept]
QSizeF operator*(qreal factor, const QSizeF &size)
이 함수는 오버로드된 함수입니다.
주어진 size 에 주어진 유한 factor 을 곱한 후 결과를 반환합니다.
[constexpr noexcept]
QSizeF operator+(const QSizeF &s1, const QSizeF &s2)
s1 와 s2 의 합계를 반환하며, 각 구성 요소는 개별적으로 추가됩니다.
[constexpr noexcept]
QSizeF operator-(const QSizeF &s1, const QSizeF &s2)
s1 에서 s2 을 뺀 값을 반환하며, 각 구성 요소는 개별적으로 뺍니다.
QSizeF operator/(const QSizeF &size, qreal divisor)
이 함수는 오버로드된 함수입니다.
주어진 size 을 주어진 divisor 으로 나누고 결과를 반환합니다. divisor 는 0이나 NaN이 아니어야 합니다.
QSizeF::scale()도 참조하세요 .
QDataStream &operator<<(QDataStream &stream, const QSizeF &size)
주어진 size 을 주어진 stream 에 쓰고 스트림에 대한 참조를 반환합니다.
Qt 데이터 유형 직렬화도참조하십시오 .
[constexpr noexcept]
bool operator==(const QSizeF &lhs, const QSizeF &rhs)
lhs 과 rhs 이 거의 같으면 true
을 반환하고, 그렇지 않으면 false 를 반환합니다.
경고: 이 함수는 엄격한 동일성을 검사하지 않고 대신 퍼지 비교를 사용하여 크기의 범위를 비교합니다.
qFuzzyCompare 를참조하세요 .
QDataStream &operator>>(QDataStream &stream, QSizeF &size)
주어진 stream 에서 주어진 size 으로 크기를 읽고 스트림에 대한 참조를 반환합니다.
Qt 데이터 유형 직렬화도참조하십시오 .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.