En esta página

QLine Class

La clase QLine proporciona un vector bidimensional con precisión entera. Más información...

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

Comparaciones de QLine

CategoríaTipos comparables
igualdadQLine
igualdadQLineF.

Funciones públicas

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)

Descripción detallada

Un QLine describe una línea de longitud finita (o un segmento de línea) en una superficie bidimensional. Los puntos inicial y final de la línea se especifican utilizando coordenadas con precisión de punto entero. Utiliza el constructor QLineF para obtener una copia en coma flotante.

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. Utilice isNull() para determinar si la QLine representa una línea válida o una línea nula.

Por último, la línea se puede desplazar una distancia determinada mediante la función translate().

Véase también QLineF, QPolygon y QRect.

Documentación de funciones miembro

[constexpr] QLine::QLine()

Crea una recta nula.

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

Crea un objeto de línea que representa la línea entre p1 y p2.

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

Crea un objeto de línea que representa la línea entre (x1, y1) y (x2, y2).

[constexpr] QPoint QLine::p1() const

Devuelve el punto inicial de la línea.

Véase también setP1(), x1(), y1() y p2().

[constexpr] QPoint QLine::p2() const

Devuelve el punto final de la línea.

Véase también setP2(), x2(), y2() y p1().

[constexpr] int QLine::x1() const

Devuelve la coordenada x del punto inicial de la línea.

Véase también p1().

[constexpr] int QLine::x2() const

Devuelve la coordenada x del punto final de la línea.

Véase también p2().

[constexpr] int QLine::y1() const

Devuelve la coordenada y del punto inicial de la línea.

Véase también p1().

[constexpr] int QLine::y2() const

Devuelve la coordenada y del punto final de la línea.

Véase también p2().

[constexpr] QPoint QLine::center() const

Devuelve el punto central de esta línea. Esto equivale a (p1()) + p2() / 2, salvo que nunca se producirá un desbordamiento.

[constexpr] int QLine::dx() const

Devuelve la componente horizontal del vector de la línea.

Véase también dy().

[constexpr] int QLine::dy() const

Devuelve la componente vertical del vector de la línea.

Véase también dx().

[constexpr] bool QLine::isNull() const

Devuelve « true » si la línea no tiene puntos de inicio y fin distintos; en caso contrario, devuelve « false ».

void QLine::setP1(const QPoint &p1)

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

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

void QLine::setP2(const QPoint &p2)

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

Véase también setP1() y p2().

void QLine::setLine(int x1, int y1, int x2, int 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 QLine::setPoints(const QPoint &p1, const QPoint &p2)

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

Véanse también setP1(), setP2(), p1() y p2().

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

Devuelve esta línea con precisión de punto flotante.

Esta función se introdujo en Qt 6.4.

Véase también QLineF::toLine().

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

Traduce esta línea según la offset indicada.

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

Traslada esta línea la distancia especificada en dx y dy.

Se trata de una función sobrecargada.

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

Devuelve esta línea traducida mediante el servicio de traducción offset.

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

Devuelve esta línea desplazada la distancia especificada por dx y dy.

Esta es una función sobrecargada.

Elementos no miembros relacionados

[constexpr noexcept] bool operator!=(const QLine &lhs, const QLine &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 alguno de sus puntos de inicio o de fin difiere, o si el orden interno de los puntos es diferente.

QDataStream &operator<<(QDataStream &stream, const QLine &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 QLine &lhs, const QLine &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, QLine &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.