QLineF Class

成员函数文档

[constexpr] QLineF::QLineF()

构造一条虚线。

[constexpr] QLineF::QLineF(const QLine &line)

根据给定的基于整数的line 构建一个QLineF对象。

另请参阅 toLine() 和QLine::toLineF()。

[constexpr] QLineF::QLineF(const QPointF &p1, const QPointF &p2)

创建一个线段对象，表示p1 与p2 之间的线段。

[constexpr] QLineF::QLineF(qreal x1, qreal y1, qreal x2, qreal y2)

构建一个线段对象，该对象表示连接 (x1,y1) 与 (x2,y2) 之间的线段。

[constexpr] QPointF QLineF::p1() const

返回该行的起始点。

另请参阅 setP1()、x1()、y1() 以及p2()。

[constexpr] QPointF QLineF::p2() const

返回该线的终点。

另请参阅 setP2()、x2()、y2() 和p1()。

[constexpr] qreal QLineF::x1() const

返回直线的起点的 x 坐标。

另请参阅 p1()。

[constexpr] qreal QLineF::x2() const

返回直线的端点的x坐标。

另请参阅 p2()。

[constexpr] qreal QLineF::y1() const

返回直线的起点的 y 坐标。

另请参阅 p1()。

[constexpr] qreal QLineF::y2() const

返回直线的端点的 y 坐标。

另请参阅 p2()。

qreal QLineF::angle() const

返回直线的角度（单位为度）。

返回值将在 0.0 到 360.0（不包括 360.0）之间。角度以逆时针方向测量，起点为原点右侧的 x 轴上某一点（x > 0）。

另请参阅 setAngle()。

qreal QLineF::angleTo(const QLineF &line) const

返回从该直线到给定直线line 的夹角（单位为度），并考虑两条直线的方向。如果两条直线在其范围内未intersect ，则以延长线的交点作为原点（参见QLineF::UnboundedIntersection ）。

返回值表示需要向该直线添加多少度，使其与给定的line 形成相同的角度（逆时针方向）。

另请参阅 intersects()。

[constexpr] QPointF QLineF::center() const

返回该直线的中心点。这等同于 0.5 *p1() + 0.5 *p2()。

[constexpr] qreal QLineF::dx() const

返回直线的向量中的水平分量。

另请参阅 dy() 和pointAt()。

[constexpr] qreal QLineF::dy() const

返回直线的向量的垂直分量。

另请参阅 dx() 和pointAt()。

[static] QLineF QLineF::fromPolar(qreal length, qreal angle)

返回一个QLineF ，其中包含给定的length 和angle 。

该直线的起始点位于原点。

角度的正值表示逆时针方向，负值表示顺时针方向。零度位于3点钟位置。

QLineF::IntersectionType QLineF::intersects(const QLineF &line, QPointF *intersectionPoint = nullptr) const

返回一个值，表示该直线是否与给定的line 相交。

实际的交点将被提取到intersectionPoint 中（如果该指针有效）。如果两条直线平行，则交点未定义。

[constexpr] bool QLineF::isNull() const

如果该线段没有不同的起始点和终点，则返回true ；否则返回false 。如果qFuzzyCompare() 能在至少一个坐标上区分起始点和终点，则认为它们是不同的。

另请参阅 qFuzzyCompare() 和length()。

qreal QLineF::length() const

返回该行的长度。

另请参阅 setLength() 和isNull()。

[constexpr] QLineF QLineF::normalVector() const

返回一条与该直线垂直、且起始点和长度均与该直线相同的直线。

另请参阅 unitVector()。

[constexpr] QPointF QLineF::pointAt(qreal t) const

返回由有限参数t 指定的位置处的点。当t = 0时，该函数返回线的起点；当t = 1时，返回线的终点。

另请参阅 dx() 和dy()。

void QLineF::setP1(const QPointF &p1)

将该线的起始点设置为p1 。

另请参阅 setP2() 和p1()。

void QLineF::setP2(const QPointF &p2)

将该线的终点设置为p2 。

另请参阅 setP1() 和p2()。

void QLineF::setAngle(qreal angle)

将直线的角度设置为给定的angle （单位为度）。这将改变直线的第二个点的位置，使直线具有给定的角度。

角度的正值表示逆时针方向，负值表示顺时针方向。零度对应3点钟位置。

另请参阅 angle()。

void QLineF::setLength(qreal length)

将线的长度设置为给定的有限值length 。QLineF 将移动线的端点 -p2() - 以使线达到新的长度，除非length() 之前为零，在这种情况下不会进行缩放。

另请参阅 length() 和unitVector()。

void QLineF::setLine(qreal x1, qreal y1, qreal x2, qreal y2)

将该行设为x1 、y1 中的起始行，以及x2 、y2 中的结束行。

另请参阅 setP1()、setP2()、p1() 和p2()。

void QLineF::setPoints(const QPointF &p1, const QPointF &p2)

将该行的起始点设置为p1 ，终点设置为p2 。

另请参阅 setP1()、setP2()、p1() 以及p2()。

[constexpr] QLine QLineF::toLine() const

返回该行基于整数的副本。

请注意，返回的行起始点和结束点会四舍五入到最接近的整数。

另请参阅 QLineF() 和QLine::toLineF()。

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

使用给定的offset 对这一行进行翻译。

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

将该行按dx 和dy 中指定的距离进行平移。

[constexpr] QLineF QLineF::translated(const QPointF &offset) const

返回由给定的offset 翻译后的该行内容。

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

返回将该行按dx 和dy 中指定的距离进行平移后的结果。

QLineF QLineF::unitVector() const

返回该直线的单位向量，即一条与该直线起点相同、长度为 1.0 的直线（前提是该直线不为空）。

另请参阅 normalVector() 和setLength()。