En esta página

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

Comparaciones de QLineF

CategoríaTipos comparables
igualdadQLineF
igualdadQLine.

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)
(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.

Recta con los puntos p1, p2, dx y dy etiquetadosRecta con los puntos x1, y1, x2, y2, dx y dy etiquetados

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.

Dos rectas con prolongaciones que se cruzanDos rectas que se cortan dentro de un rectángulo
QLineF::UnboundedIntersectionQLineF::BoundedIntersection
ConstanteValorDescripción
QLineF::NoIntersection0Indica que las líneas no se cruzan; es decir, que son paralelas.
QLineF::UnboundedIntersection2Las 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::BoundedIntersection1Las 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.

Diagrama en el que se muestran dos vectores con el mismo punto de partida: (v_x, v_y) y (vy, -vx).

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.

Véanse también dx() y dy().

void QLineF::setP1(const QPointF &p1)

Establece el punto inicial de esta línea en p1.

Véase también setP2() y p1().

void QLineF::setP2(const QPointF &p2)

Establece el punto final de esta línea en p2.

Véase también setP1() y 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.