QPointF Class

QPointF 클래스는 부동 소수점 정밀도를 사용하여 평면의 한 점을 정의합니다. 더 보기...

Header: #include <QPointF>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

이 클래스는 동등 비교 가능합니다.

이 클래스는 QPoint동등 비교 가능합니다.

참고: 이 클래스의 모든 함수는 재진입합니다.

공용 함수

QPointF()
QPointF(const QPoint &point)
QPointF(qreal xpos, qreal ypos)
bool isNull() const
qreal manhattanLength() const
qreal &rx()
qreal &ry()
void setX(qreal x)
void setY(qreal y)
CGPoint toCGPoint() const
QPoint toPoint() const
QPointF transposed() const
qreal x() const
qreal y() const
QPointF &operator*=(qreal factor)
QPointF &operator+=(const QPointF &point)
QPointF &operator-=(const QPointF &point)
QPointF &operator/=(qreal divisor)

정적 공용 멤버

qreal dotProduct(const QPointF &p1, const QPointF &p2)
QPointF fromCGPoint(CGPoint point)
(since 6.8) bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)
(since 6.8) bool qFuzzyIsNull(const QPointF &point)
bool operator!=(const QPointF &lhs, const QPointF &rhs)
QPointF operator*(const QPointF &point, qreal factor)
QPointF operator*(qreal factor, const QPointF &point)
QPointF operator+(const QPointF &point)
QPointF operator+(const QPointF &p1, const QPointF &p2)
QPointF operator-(const QPointF &p1, const QPointF &p2)
QPointF operator-(const QPointF &point)
QPointF operator/(const QPointF &point, qreal divisor)
QDataStream &operator<<(QDataStream &stream, const QPointF &point)
bool operator==(const QPointF &lhs, const QPointF &rhs)
QDataStream &operator>>(QDataStream &stream, QPointF &point)

상세 설명

점은 x() 및 y() 함수를 사용하여 액세스할 수 있는 x 좌표와 y 좌표로 지정됩니다. 점의 좌표는 정확성을 위해 유한 부동 소수점 숫자를 사용하여 지정됩니다. isNull () 함수는 x와 y가 모두 0.0으로 설정된 경우 true 을 반환합니다. 좌표는 setX() 및 setY() 함수 또는 좌표에 대한 참조를 반환하는 rx() 및 ry() 함수(직접 조작 가능)를 사용하여 설정(또는 변경)할 수 있습니다.

p가 주어지면 다음 문은 모두 동일합니다:

QPointF p;

p.setX(p.x() + 1.0);
p += QPointF(1.0, 0.0);
p.rx()++;

QPointF 객체는 벡터로도 사용할 수 있습니다: 덧셈과 뺄셈은 벡터에 대해 정의됩니다(각 구성 요소는 개별적으로 추가됨). QPointF 객체는 int 또는 qreal 로 나누거나 곱할 수도 있습니다.

또한 QPointF 클래스는 QPoint 객체를 QPointF 객체로 변환하는 생성자와 점의 QPoint 복사본을 반환하는 해당 toPoint() 함수를 제공합니다. 마지막으로, QPointF 객체를 스트리밍할 수 있을 뿐만 아니라 비교할 수도 있습니다.

QPointQPolygonF참조하십시오 .

멤버 함수 문서

[constexpr noexcept] QPointF::QPointF()

좌표(0.0, 0.0)를 사용하여 영점을 생성합니다.

isNull()도 참조하세요 .

[constexpr noexcept] QPointF::QPointF(const QPoint &point)

주어진 point 의 복사본을 생성합니다.

toPoint() 및 QPoint::toPointF()도 참조하세요 .

[constexpr noexcept] QPointF::QPointF(qreal xpos, qreal ypos)

주어진 좌표로 점을 만듭니다 (xpos, ypos).

setX() 및 setY()도 참조하세요 .

[static constexpr] qreal QPointF::dotProduct(const QPointF &p1, const QPointF &p2)

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
qreal dotProduct = QPointF::dotProduct(p, q);   // dotProduct becomes 26.01

p1p2 의 도트 곱을 반환합니다.

[static noexcept] QPointF QPointF::fromCGPoint(CGPoint point)

CGPoint point 에서 QRectF 을 생성합니다.

toCGPoint()도 참조하세요 .

[noexcept] bool QPointF::isNull() const

x 및 y 좌표가 모두 0.0으로 설정된 경우 true 을 반환하고(부호 무시), 그렇지 않으면 false 을 반환합니다.

[constexpr] qreal QPointF::manhattanLength() const

x() 및 y()의 절대값의 합을 반환하며, 일반적으로 원점에서 점까지의 벡터의 '맨해튼 길이'로 알려져 있습니다.

QPoint::manhattanLength()도 참조하세요 .

[constexpr noexcept] qreal &QPointF::rx()

이 지점의 x 좌표에 대한 참조를 반환합니다.

참조를 사용하면 x를 직접 조작할 수 있습니다:

 QPointF p(1.1, 2.5);
 p.rx()--;   // p becomes (0.1, 2.5)

x() 및 setX()도 참조하세요 .

[constexpr noexcept] qreal &QPointF::ry()

이 점의 y 좌표에 대한 참조를 반환합니다.

참조를 사용하면 y를 직접 조작할 수 있습니다:

QPointF p(1.1, 2.5);
p.ry()++;   // p becomes (1.1, 3.5)

y() 및 setY()도 참조하세요 .

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

이 점의 x 좌표를 주어진 유한 x 좌표로 설정합니다.

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

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

이 점의 y 좌표를 주어진 유한 y 좌표로 설정합니다.

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

[noexcept] CGPoint QPointF::toCGPoint() const

QPointF 에서 CGPoint를 생성합니다.

fromCGPoint()도 참조하세요 .

[constexpr] QPoint QPointF::toPoint() const

이 점의 좌표를 가장 가까운 정수로 반올림하고 반올림된 좌표가 포함된 QPoint 객체를 반환합니다.

QPointF() 및 QPoint::toPointF()도 참조하세요 .

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

x와 y 좌표가 교환된 점을 반환합니다:

QPointF{1.0, 2.0}.transposed() // {2.0, 1.0}

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

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

이 지점의 x 좌표를 반환합니다.

setX() 및 rx()도 참조하세요 .

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

이 지점의 y 좌표를 반환합니다.

setY() 및 ry()도 참조하세요 .

[constexpr] QPointF &QPointF::operator*=(qreal factor)

이 점의 좌표에 주어진 유한값 factor 을 곱하고 이 점에 대한 참조를 반환합니다. 예를 들어:

QPointF p(-1.1, 4.1);
p *= 2.5;    // p becomes (-2.75, 10.25)

operator/=()도 참조하세요 .

[constexpr] QPointF &QPointF::operator+=(const QPointF &point)

주어진 point 을 이 지점에 추가하고 이 지점에 대한 참조를 반환합니다. 예를 들어:

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p += q;    // p becomes (2.1, 11.2)

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

[constexpr] QPointF &QPointF::operator-=(const QPointF &point)

이 지점에서 주어진 point 을 빼고 이 지점에 대한 참조를 반환합니다. 예를 들어

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p -= q;    // p becomes (4.1, 3.0)

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

[constexpr] QPointF &QPointF::operator/=(qreal divisor)

x와 y를 주어진 divisor 으로 나누고 이 지점에 대한 참조를 반환합니다. 예를 들어

QPointF p(-2.75, 10.25);
p /= 2.5;           // p becomes (-1.1, 4.1)

divisor 은 0이나 NaN이 아니어야 합니다.

operator*=()도 참조하세요 .

관련 비회원

[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)

p1p2 과 거의 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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

qFuzzyIsNull참조하십시오 .

[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QPointF &point)

point 이 점 (0.0, 0.0) 과 거의 같으면 true 을 반환합니다.

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

qFuzzyCompare도 참조하십시오 .

[constexpr noexcept] bool operator!=(const QPointF &lhs, const QPointF &rhs)

lhsrhs 과 충분히 다르면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

경고: 이 함수는 엄격한 부등식을 검사하지 않고 대신 퍼지 비교를 사용하여 점의 좌표를 비교합니다.

qFuzzyCompare참조하세요 .

[constexpr] QPointF operator*(const QPointF &point, qreal factor)

주어진 point 의 복사본에 주어진 유한 factor 을 곱한 값을 반환합니다.

QPointF::operator*=()도 참조하세요 .

[constexpr] QPointF operator*(qreal factor, const QPointF &point)

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

주어진 point 의 복사본에 주어진 유한 factor 을 곱한 값을 반환합니다.

[constexpr] QPointF operator+(const QPointF &point)

point 수정되지 않은 상태로 반환합니다.

[constexpr] QPointF operator+(const QPointF &p1, const QPointF &p2)

주어진 포인트( p1p2)의 합계인 QPointF 객체를 반환하며, 각 구성 요소는 개별적으로 추가됩니다.

QPointF::operator+=()도 참조하세요 .

[constexpr] QPointF operator-(const QPointF &p1, const QPointF &p2)

p1 에서 p2 을 빼서 형성된 QPointF 객체를 반환합니다; 각 구성 요소는 개별적으로 빼집니다.

QPointF::operator-=()도 참조하세요 .

[constexpr] QPointF operator-(const QPointF &point)

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

주어진 point 의 각 구성 요소의 부호를 변경하여 형성된 QPointF 객체를 반환합니다.

QPointF(0,0) - point 와 동일합니다.

[constexpr] QPointF operator/(const QPointF &point, qreal divisor)

주어진 point 의 각 컴포넌트를 주어진 divisor 로 나누어 형성된 QPointF 객체를 반환합니다.

divisor 은 0이나 NaN 이 아니어야 합니다.

QPointF::operator/=()도 참조하세요 .

QDataStream &operator<<(QDataStream &stream, const QPointF &point)

주어진 point 을 주어진 stream 에 쓰고 스트림에 대한 참조를 반환합니다.

Qt 데이터 유형 직렬화도참조하십시오 .

[constexpr noexcept] bool operator==(const QPointF &lhs, const QPointF &rhs)

lhsrhs 과 거의 같으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

경고: 이 함수는 엄격한 동일성을 검사하지 않고 대신 퍼지 비교를 사용하여 점의 좌표를 비교합니다.

qFuzzyCompare참조하세요 .

QDataStream &operator>>(QDataStream &stream, QPointF &point)

주어진 stream 에서 주어진 point 으로 점을 읽고 스트림에 대한 참조를 반환합니다.

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.