이 페이지에서

QLine Class

QLine 클래스는 정수 정밀도를 사용하는 2차원 벡터를 제공합니다. 더 보기...

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

QLine 비교

범주비교 가능한 유형
동등성QLine
동등성QLineF.

공개 함수

QLine()
QLine(const QPoint &p1, const QPoint &p2)
QLine(int x1, int y1, int x2, int y2)
QPoint p1() const
QPoint p2() const
int x1() const
int x2() const
int y1() const
int y2() const
QPoint center() const
int dx() const
int dy() const
bool isNull() const
void setP1(const QPoint &p1)
void setP2(const QPoint &p2)
void setLine(int x1, int y1, int x2, int y2)
void setPoints(const QPoint &p1, const QPoint &p2)
(since 6.4) QLineF toLineF() const
void translate(const QPoint &offset)
void translate(int dx, int dy)
QLine translated(const QPoint &offset) const
QLine translated(int dx, int dy) const
bool operator!=(const QLine &lhs, const QLine &rhs)
QDataStream &operator<<(QDataStream &stream, const QLine &line)
bool operator==(const QLine &lhs, const QLine &rhs)
QDataStream &operator>>(QDataStream &stream, QLine &line)

상세 설명

QLine은 2차원 평면상의 유한한 길이의 선(또는 선분)을 나타냅니다. 선의 시작점과 끝점은 좌표에 대한 정수 점 정확도를 사용하여 지정됩니다. 부동 소수점 형식의 복사본을 얻으려면 QLineF 생성자를 사용하십시오.

p1, p2, dx, dy가 표시된 직선x1, y1, x2, y2, dx, dy가 표시된 선

선의 시작점과 끝점의 위치는 p1(), x1(), y1(), p2(), x2() 및 y2() 함수를 사용하여 가져올 수 있습니다. dx() 및 dy() 함수는 선의 수평 및 수직 성분을 반환합니다. isNull()를 사용하여 QLine이 유효한 선을 나타내는지 아니면 null 선을 나타내는지 확인하십시오.

마지막으로, translate() 함수를 사용하여 선을 지정된 오프셋만큼 이동시킬 수 있습니다.

QLineF, QPolygon 및 QRect도 참조하십시오 .

멤버 함수 설명서

[constexpr] QLine::QLine()

널 라인을 생성합니다.

[constexpr] QLine::QLine(const QPoint &p1, const QPoint &p2)

p1 와 p2 사이의 선을 나타내는 선 객체를 생성합니다.

[constexpr] QLine::QLine(int x1, int y1, int x2, int y2)

(x1, y1)과 (x2, y2) 사이의 선을 나타내는 선 객체를 생성합니다.

[constexpr] QPoint QLine::p1() const

줄의 시작점을 반환합니다.

setP1(), x1(), y1(), p2()도 참조하십시오 .

[constexpr] QPoint QLine::p2() const

줄의 끝점을 반환합니다.

setP2(), x2(), y2(), p1()도 참조하십시오 .

[constexpr] int QLine::x1() const

선의 시작점의 x 좌표를 반환합니다.

p1()도 참조하십시오 .

[constexpr] int QLine::x2() const

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

p2()도 참조하십시오 .

[constexpr] int QLine::y1() const

선의 시작점의 y-좌표를 반환합니다.

p1()도 참조하십시오 .

[constexpr] int QLine::y2() const

선의 끝점의 y-좌표를 반환합니다.

p2()도 참조하십시오 .

[constexpr] QPoint QLine::center() const

이 선분의 중심점을 반환합니다. 이는 (p1()) + p2()) / 2와 동일하지만, 오버플로가 발생하지 않는다는 점이 다릅니다.

[constexpr] int QLine::dx() const

선 벡터의 수평 성분을 반환합니다.

dy()도 참조하십시오 .

[constexpr] int QLine::dy() const

선 벡터의 수직 성분을 반환합니다.

dx()도 참조하십시오 .

[constexpr] bool QLine::isNull() const

해당 선에 명확한 시작점과 끝점이 없는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

void QLine::setP1(const QPoint &p1)

이 선의 시작점을 p1 로 설정합니다.

setP2() 및 p1()도 참조하십시오 .

void QLine::setP2(const QPoint &p2)

이 선의 끝점을 p2 로 설정합니다.

setP1() 및 p2()도 참조하십시오 .

void QLine::setLine(int x1, int y1, int x2, int y2)

이 줄을 x1, y1 에서 시작하도록, x2, y2 에서 끝나는 것으로 설정합니다.

setP1(), setP2(), p1() 및 p2()도 참조하십시오 .

void QLine::setPoints(const QPoint &p1, const QPoint &p2)

이 선의 시작점을 p1 로, 끝점을 p2 로 설정합니다.

setP1(), setP2(), p1() 및 p2()도 참조하십시오 .

[constexpr noexcept, since 6.4] QLineF QLine::toLineF() const

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

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

QLineF::toLine()도 참조하십시오 .

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

주어진 offset 에 따라 이 줄을 번역합니다.

[constexpr] void QLine::translate(int dx, int dy)

이 줄을 dx 및 dy 에 지정된 거리만큼 이동시킵니다.

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

[constexpr] QLine QLine::translated(const QPoint &offset) const

지정된 offset 를 사용하여 이 줄을 번역한 결과를 반환합니다.

[constexpr] QLine QLine::translated(int dx, int dy) const

dx 와 dy 에서 지정한 거리만큼 이 줄을 이동시켜 반환합니다.

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

관련 비회원 요소

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

lhs 줄과 rhs 줄이 서로 다르다면 true 를 반환합니다.

두 선분은 시작점이나 끝점 중 하나라도 다르거나, 점들의 내부 순서가 다를 경우 서로 다른 것으로 간주합니다.

QDataStream &operator<<(QDataStream &stream, const QLine &line)

지정된 ` line `를 지정된 ` stream `에 기록하고, 해당 스트림에 대한 참조를 반환합니다.

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

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

lhs 행이 rhs 행과 동일할 경우 true 을 반환합니다.

두 선이 서로 동일하다는 것은 시작점과 끝점이 동일하고, 점들의 내부 순서도 같을 때를 말합니다.

QDataStream &operator>>(QDataStream &stream, QLine &line)

지정된 ` stream `에서 한 줄을 읽어 지정된 ` line `에 저장하고, 해당 스트림에 대한 참조를 반환합니다.

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

© 2026 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.