QLineF Class
La clase QLineF proporciona un vector bidimensional con precisión de coma flotante. Más información...
| Encabezado: | #include <QLineF> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QLineF forma parte de las clases de pintura.
Comparaciones de QLineF
| Categoría | Tipos comparables |
|---|---|
| igualdad | QLineF |
| igualdad | QLine. |
Tipos públicos
| enum | IntersectionType { NoIntersection, UnboundedIntersection, BoundedIntersection } |
Funciones públicas
| QLineF() | |
| QLineF(const QLine &line) | |
| QLineF(const QPointF &p1, const QPointF &p2) | |
| QLineF(qreal x1, qreal y1, qreal x2, qreal y2) | |
| QPointF | p1() const |
| QPointF | p2() const |
| qreal | x1() const |
| qreal | x2() const |
| qreal | y1() const |
| qreal | y2() const |
| qreal | angle() const |
| qreal | angleTo(const QLineF &line) const |
| QPointF | center() const |
| qreal | dx() const |
| qreal | dy() const |
| QLineF::IntersectionType | intersects(const QLineF &line, QPointF *intersectionPoint = nullptr) const |
| bool | isNull() const |
| qreal | length() const |
| QLineF | normalVector() const |
| QPointF | pointAt(qreal t) const |
| void | setP1(const QPointF &p1) |
| void | setP2(const QPointF &p2) |
| void | setAngle(qreal angle) |
| void | setLength(qreal length) |
| void | setLine(qreal x1, qreal y1, qreal x2, qreal y2) |
| void | setPoints(const QPointF &p1, const QPointF &p2) |
| QLine | toLine() const |
| void | translate(const QPointF &offset) |
| void | translate(qreal dx, qreal dy) |
| QLineF | translated(const QPointF &offset) const |
| QLineF | translated(qreal dx, qreal dy) const |
| QLineF | unitVector() const |
Miembros públicos estáticos
| QLineF | fromPolar(qreal length, qreal angle) |
Elementos no miembros relacionados
(since 6.8) bool | qFuzzyCompare(const QLineF &lhs, const QLineF &rhs) |
(since 6.8) bool | qFuzzyIsNull(const QLineF &line) |
| bool | operator!=(const QLineF &lhs, const QLineF &rhs) |
| QDataStream & | operator<<(QDataStream &stream, const QLineF &line) |
| bool | operator==(const QLineF &lhs, const QLineF &rhs) |
| QDataStream & | operator>>(QDataStream &stream, QLineF &line) |
Descripción detallada
Un QLineF describe una línea (o segmento de línea) de longitud finita en una superficie bidimensional. QLineF define los puntos inicial y final de la línea utilizando precisión de punto flotante para las coordenadas. Utiliza la función toLine() para obtener una copia de esta línea basada en números enteros.
![]() | ![]() |
Las posiciones de los puntos inicial y final de la línea se pueden obtener mediante las funciones p1(), x1(), y1(), p2(), x2() y y2(). Las funciones dx() y dy() devuelven las componentes horizontal y vertical de la línea, respectivamente.
La longitud de la línea se puede obtener mediante la función length() y modificarse mediante la función setLength(). Del mismo modo, las funciones angle() y setAngle() se utilizan, respectivamente, para obtener y modificar el ángulo de la línea. Utiliza la función isNull() para determinar si el objeto QLineF representa una línea válida o una línea nula.
La función intersects() determina el ángulo de intersección ( IntersectionType ) entre esta línea y una línea dada, mientras que la función angleTo() devuelve el ángulo entre las líneas. Además, la función unitVector() devuelve una línea que tiene el mismo punto de inicio que esta línea, pero con una longitud de solo 1, mientras que la función normalVector() devuelve una línea que es perpendicular a esta línea y que tiene el mismo punto de inicio y la misma longitud.
Por último, la recta se puede desplazar una distancia determinada mediante la función translate(), y se puede recorrer mediante la función pointAt().
Restricciones
QLine está limitada a los valores mínimo y máximo del tipo « int ». Las operaciones sobre una « QLine » que puedan dar lugar a valores fuera de este rango provocarán un comportamiento indefinido.
Véase también « QLine », « QPolygonF » y « QRectF ».
Documentación sobre tipos de miembro
enum QLineF::IntersectionType
Describe la intersección entre dos rectas.
![]() | ![]() |
| QLineF::UnboundedIntersection | QLineF::BoundedIntersection |
| Constante | Valor | Descripción |
|---|---|---|
QLineF::NoIntersection | 0 | Indica que las líneas no se cruzan; es decir, que son paralelas. |
QLineF::UnboundedIntersection | 2 | Las dos líneas se cruzan, pero no dentro del intervalo definido por sus longitudes. Este será el caso si las líneas no son paralelas. La función intersect() también devolverá este valor si el punto de intersección se encuentra entre el punto inicial y el punto final de solo una de las líneas. |
QLineF::BoundedIntersection | 1 | Las dos rectas se cortan entre sí dentro de los puntos inicial y final de cada una de ellas. |
Véase también intersects().
Documentación de funciones miembro
[constexpr] QLineF::QLineF()
Crea una recta nula.
[constexpr] QLineF::QLineF(const QLine &line)
Crea un objeto QLineF a partir de la cadena « line » basada en números enteros que se ha proporcionado.
Véanse también toLine() y QLine::toLineF().
[constexpr] QLineF::QLineF(const QPointF &p1, const QPointF &p2)
Crea un objeto de línea que representa la línea entre p1 y p2.
[constexpr] QLineF::QLineF(qreal x1, qreal y1, qreal x2, qreal y2)
Crea un objeto de línea que representa la línea entre (x1, y1) y (x2, y2).
[constexpr] QPointF QLineF::p1() const
Devuelve el punto inicial de la línea.
Véase también setP1(), x1(), y1() y p2().
[constexpr] QPointF QLineF::p2() const
Devuelve el punto final de la línea.
Véase también setP2(), x2(), y2() y p1().
[constexpr] qreal QLineF::x1() const
Devuelve la coordenada x del punto inicial de la línea.
Véase también p1().
[constexpr] qreal QLineF::x2() const
Devuelve la coordenada x del punto final de la línea.
Véase también p2().
[constexpr] qreal QLineF::y1() const
Devuelve la coordenada y del punto inicial de la línea.
Véase también p1().
[constexpr] qreal QLineF::y2() const
Devuelve la coordenada y del punto final de la línea.
Véase también p2().
qreal QLineF::angle() const
Devuelve el ángulo de la recta en grados.
El valor devuelto estará comprendido entre 0,0 y 360,0, sin incluir este último. Los ángulos se miden en sentido antihorario desde un punto del eje x situado a la derecha del origen (x > 0).
Véase también setAngle().
qreal QLineF::angleTo(const QLineF &line) const
Devuelve el ángulo (en grados) entre esta línea y la línea dada line, teniendo en cuenta la dirección de las líneas. Si las líneas no se intersect dentro de su rango, se toma como origen el punto de intersección de las líneas prolongadas (véase QLineF::UnboundedIntersection).
El valor devuelto representa el número de grados que hay que sumar a esta línea para que tenga el mismo ángulo que la línea dada line, en sentido antihorario.
Véase también intersects().
[constexpr] QPointF QLineF::center() const
Devuelve el punto central de esta línea. Esto equivale a 0,5 * p1() + 0,5 * p2().
[constexpr] qreal QLineF::dx() const
Devuelve la componente horizontal del vector de la línea.
Véase también dy() y pointAt().
[constexpr] qreal QLineF::dy() const
Devuelve la componente vertical del vector de la línea.
Véase también dx() y pointAt().
[static] QLineF QLineF::fromPolar(qreal length, qreal angle)
Devuelve un objeto ` QLineF ` con los valores ` length ` y ` angle` indicados.
El primer punto de la línea estará en el origen.
Los valores positivos de los ángulos indican una rotación en sentido antihorario, mientras que los valores negativos indican una rotación en sentido horario. Cero grados corresponde a la posición de las 3 en punto.
QLineF::IntersectionType QLineF::intersects(const QLineF &line, QPointF *intersectionPoint = nullptr) const
Devuelve un valor que indica si esta línea se cruza o no con la línea dada line.
El punto de intersección real se extrae a ` intersectionPoint ` (si el puntero es válido). Si las líneas son paralelas, el punto de intersección no está definido.
[constexpr] bool QLineF::isNull() const
Devuelve ` true ` si la línea no tiene puntos de inicio y fin distintos; en caso contrario, devuelve ` false`. Los puntos de inicio y fin se consideran distintos si ` qFuzzyCompare()` puede distinguirlos en al menos una coordenada.
Nota: Debido al uso de la comparación difusa, isNull() puede devolver true para líneas cuyo length() no sea cero.
Véanse también qFuzzyCompare() y length().
qreal QLineF::length() const
Devuelve la longitud de la línea.
Véase también setLength() y isNull().
[constexpr] QLineF QLineF::normalVector() const
Devuelve una recta perpendicular a esta recta, con el mismo punto de inicio y la misma longitud.

Véase también unitVector().
[constexpr] QPointF QLineF::pointAt(qreal t) const
Devuelve el punto situado en la posición especificada por el parámetro finito t. La función devuelve el punto inicial de la línea si t = 0, y su punto final si t = 1.
void QLineF::setP1(const QPointF &p1)
Establece el punto inicial de esta línea en p1.
void QLineF::setP2(const QPointF &p2)
Establece el punto final de esta línea en p2.
void QLineF::setAngle(qreal angle)
Establece el ángulo de la recta según el angle dado (en grados). Esto modificará la posición del segundo punto de la recta de tal forma que esta forme el ángulo indicado.
Los valores positivos del ángulo indican una rotación en sentido antihorario, mientras que los valores negativos indican una rotación en sentido horario. Cero grados corresponde a la posición de las 3 en punto.
Véase también angle().
void QLineF::setLength(qreal length)
Establece la longitud de la línea en el valor finito dado length. QLineF desplazará el punto final — p2()— de la línea para darle a esta su nueva longitud, a menos que length() fuera previamente cero, en cuyo caso no se intentará realizar ningún escalado.
Véanse también length() y unitVector().
void QLineF::setLine(qreal x1, qreal y1, qreal x2, qreal y2)
Establece esta línea como inicio en x1, y1 y como fin en x2, y2.
Véase también setP1(), setP2(), p1() y p2().
void QLineF::setPoints(const QPointF &p1, const QPointF &p2)
Establece el punto inicial de esta línea en p1 y el punto final en p2.
Véase también setP1(), setP2(), p1() y p2().
[constexpr] QLine QLineF::toLine() const
Devuelve una copia de esta línea basada en números enteros.
Ten en cuenta que los puntos inicial y final de la línea devuelta se redondean al entero más cercano.
Véase también QLineF() y QLine::toLineF().
[constexpr] void QLineF::translate(const QPointF &offset)
Traduce esta línea según el « offset » indicado.
[constexpr] void QLineF::translate(qreal dx, qreal dy)
Traslada esta línea la distancia especificada en dx y dy.
Se trata de una función sobrecargada.
[constexpr] QLineF QLineF::translated(const QPointF &offset) const
Devuelve esta línea traducida mediante el servicio de traducción offset.
[constexpr] QLineF QLineF::translated(qreal dx, qreal dy) const
Devuelve esta línea desplazada la distancia especificada por dx y dy.
Esta es una función sobrecargada.
QLineF QLineF::unitVector() const
Devuelve el vector unitario de esta recta, es decir, una recta que parte del mismo punto que esta y tiene una longitud de 1,0, siempre que la recta no sea nula.
Véase también normalVector() y setLength().
Elementos no miembros relacionados
[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QLineF &lhs, const QLineF &rhs)
Devuelve « true » si la línea « lhs » es aproximadamente igual a la línea « rhs »; en caso contrario, devuelve « false ».
Las líneas se consideran aproximadamente iguales si sus puntos inicial y final son aproximadamente iguales.
Esta función se introdujo en Qt 6.8.
[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QLineF &line)
Devuelve « true » si el punto inicial de la línea « line » es aproximadamente igual a su punto final; en caso contrario, devuelve « false ».
Esta función se introdujo en Qt 6.8.
[constexpr noexcept] bool operator!=(const QLineF &lhs, const QLineF &rhs)
Devuelve « true » si la línea « lhs » no es la misma que la línea « rhs ».
Una línea es diferente de otra si sus puntos inicial o final difieren, o si el orden interno de los puntos es diferente.
QDataStream &operator<<(QDataStream &stream, const QLineF &line)
Escribe el objeto ` line ` especificado en el objeto ` stream ` especificado y devuelve una referencia al flujo.
Véase también «Serialización detipos de datos de Qt».
[constexpr noexcept] bool operator==(const QLineF &lhs, const QLineF &rhs)
Devuelve « true » si la línea lhs es igual a la línea rhs.
Una línea es idéntica a otra si los puntos inicial y final son idénticos y el orden interno de los puntos es el mismo.
QDataStream &operator>>(QDataStream &stream, QLineF &line)
Lee una línea del archivo « stream » especificado y la escribe en el archivo « line » especificado, y devuelve una referencia al flujo.
Véase también Serialización detipos de datos de 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.



