En esta página

QLine Class

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

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

Esta clase es igual-comparable.

Esta clase es comparable con QLineF.

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

Una 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 precisión de punto entero para las coordenadas. Utilice el constructor QLineF para obtener una copia en coma flotante.

Las posiciones de los puntos inicial y final de la línea pueden recuperarse utilizando 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 puede trasladarse un desplazamiento dado utilizando la función translate().

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

Documentación de las funciones miembro

[constexpr] QLine::QLine()

Construye una línea nula.

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

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

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

Construye un objeto 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 es equivalente a (p1() + p2()) / 2, excepto que nunca se desbordará.

[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 inicial y final 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)

Fija esta línea al inicio en x1, y1 y al final 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 de esta línea en p2.

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

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

Devuelve esta línea como una línea con precisión de coma 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 por la dirección offset.

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

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

Se trata de una función sobrecargada.

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

Devuelve esta línea traducida por el offset dado .

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

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

Se trata de una función sobrecargada.

No miembros relacionados

[constexpr noexcept] bool operator!=(const QLine &lhs, const QLine &rhs)

Devuelve true si la línea lhs no es igual a la línea rhs.

Una línea es diferente de otra si alguno de sus puntos inicial o final difiere, o si el orden interno de los puntos es diferente.

QDataStream &operator<<(QDataStream &stream, const QLine &line)

Escribe el line dado en el stream dado y devuelve una referencia al flujo.

Véase también Serializar tipos de datos Qt.

[constexpr noexcept] bool operator==(const QLine &lhs, const QLine &rhs)

Devuelve true si la línea lhs es idéntica 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 stream dado en el line dado y devuelve una referencia al flujo.

Véase también Serializar tipos de datos 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.