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。角度是从 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)

返回带有给定length 和angle 的QLineF 。

直线的第一个点将位于原点上。

角度的正值表示逆时针方向，负值表示顺时针方向。零度位于 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()。

void QLineF::translate(const QPointF &offset)

用给定的offset 翻译这一行。

void QLineF::translate(qreal dx, qreal dy)

这是一个重载函数。

按照dx 和dy 指定的距离平移此行。

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

Returns this line translated by the givenoffset.

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

这是一个重载函数。

按dx 和dy 指定的距离返回这条直线的平移结果。

QLineF QLineF::unitVector() const

返回此直线的单位向量，即与此直线起点相同、长度为 1.0 的直线，前提是此直线非空。

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