QPoint Class

멤버 함수 문서

[constexpr noexcept] QPoint::QPoint()

좌표가 (0, 0)인 영점을 생성합니다.

isNull()도 참조하십시오 .

[constexpr noexcept] QPoint::QPoint(int xpos, int ypos)

주어진 좌표(xpos, ypos)를 가진 점을 생성합니다.

setX() 및 setY()도 참조하십시오 .

[static constexpr] int QPoint::dotProduct(const QPoint &p1, const QPoint &p2)

QPoint p( 3, 7);
QPoint q(-1, 4);
int dotProduct = QPoint::dotProduct(p, q);   // dotProduct becomes 25

p1 와 p2 의 내적을 반환합니다.

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

x 및 y 좌표가 모두 0으로 설정된 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

[constexpr] int QPoint::manhattanLength() const

x()와 y()의 절댓값의 합을 반환하며, 이는 전통적으로 원점부터 해당 점까지의 벡터 “맨해튼 길이”로 알려져 있습니다. 예를 들어:

QPoint oldPosition;

void MyWidget::mouseMoveEvent(QMouseEvent *event)
{
    QPoint point = event->pos() - oldPosition;
    if (point.manhattanLength() > 3){
        // the mouse has moved more than 3 pixels since the oldPosition
    }
}

이는 실제 길이에 대한 유용하고 계산이 빠른 근사값입니다:

double trueLength = std::sqrt(std::pow(x(), 2) + std::pow(y(), 2));

“맨해튼 길이”라는 명칭이 생겨난 배경은, 이러한 거리가 맨해튼의 거리처럼 직사각형 격자 상에서만 이동할 수 있는 여행자들에게 적용되기 때문입니다.

[constexpr noexcept] int &QPoint::rx()

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

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

QPoint p(1, 2);
p.rx()--;   // p becomes (0, 2)

x() 및 setX()도 참조하십시오 .

[constexpr noexcept] int &QPoint::ry()

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

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

QPoint p(1, 2);
p.ry()++;   // p becomes (1, 3)

y() 및 setY()도 참조하십시오 .

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

이 점의 x 좌표를 지정된 x 좌표로 설정합니다.

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

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

이 점의 y 좌표를 지정된 y 좌표로 설정합니다.

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

[noexcept] CGPoint QPoint::toCGPoint() const

QPoint 에서 CGPoint를 생성합니다.

QPointF::fromCGPoint()도 참조하십시오 .

[constexpr noexcept, since 6.4] QPointF QPoint::toPointF() const

이 점을 부동소수점 정밀도를 가진 점으로 반환합니다.

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

QPointF::toPoint()도 참조하십시오 .

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

x와 y 좌표가 바뀐 점을 반환합니다:

QPoint{1, 2}.transposed() // {2, 1}

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

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

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

setX() 및 rx()도 참조하십시오 .

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

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

setY() 및 ry()도 참조하십시오 .

[constexpr] QPoint &QPoint::operator*=(double factor)

이 점의 좌표를 주어진 factor 로 곱한 후, 이 점에 대한 참조를 반환합니다. 예를 들어:

QPoint p(-1, 4);
p *= 2.5;    // p becomes (-3, 10)

점은 정수형으로 저장되므로 결과는 가장 가까운 정수로 반올림된다는 점에 유의하십시오. 부동 소수점 수준의 정확도가 필요한 경우 ` QPointF `를 사용하십시오.

operator/=()도 참조하십시오 .

[constexpr] QPoint &QPoint::operator*=(float factor)

이 점의 좌표에 지정된 factor 값을 곱한 후, 이 점에 대한 참조를 반환합니다.

점은 정수형으로 저장되므로, 결과는 가장 가까운 정수로 반올림된다는 점에 유의하십시오. 부동 소수점 정밀도를 원할 경우 ` QPointF `를 사용하십시오.

operator/=()도 참조하십시오 .

[constexpr] QPoint &QPoint::operator*=(int factor)

이 점의 좌표를 주어진 factor 값으로 곱한 후, 이 점에 대한 참조를 반환합니다.

operator/=()도 참조하십시오 .

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

지정된 point 를 이 점에 추가하고, 이 점에 대한 참조를 반환합니다. 예:

QPoint p( 3, 7);
QPoint q(-1, 4);
p += q;    // p becomes (2, 11)

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

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

지정된 좌표 point 를 현재 지점에서 빼고, 이 지점에 대한 참조를 반환합니다. 예:

QPoint p( 3, 7);
QPoint q(-1, 4);
p -= q;    // p becomes (4, 3)

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

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

x와 y를 모두 주어진 divisor 로 나눈 뒤, 이 점에 대한 참조를 반환합니다. 예시:

QPoint p(-3, 10);
p /= 2.5;           // p becomes (-1, 4)

점은 정수형으로 저장되므로 결과는 가장 가까운 정수로 반올림된다는 점에 유의하십시오. 부동소수점 정밀도를 원할 경우 ` QPointF `를 사용하십시오.

operator*=()도 참조하십시오 .