En esta página

QPointF Class

La clase QPointF define un punto en el plano utilizando precisión de coma flotante. Más...

Cabecera: #include <QPointF>
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 QPoint.

Nota: Todas las funciones de esta clase son reentrantes.

Funciones Públicas

QPointF()
QPointF(const QPoint &point)
QPointF(qreal xpos, qreal ypos)
bool isNull() const
qreal manhattanLength() const
qreal &rx()
qreal &ry()
void setX(qreal x)
void setY(qreal y)
CGPoint toCGPoint() const
QPoint toPoint() const
QPointF transposed() const
qreal x() const
qreal y() const
QPointF &operator*=(qreal factor)
QPointF &operator+=(const QPointF &point)
QPointF &operator-=(const QPointF &point)
QPointF &operator/=(qreal divisor)

Miembros públicos estáticos

qreal dotProduct(const QPointF &p1, const QPointF &p2)
QPointF fromCGPoint(CGPoint point)
(since 6.8) bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)
(since 6.8) bool qFuzzyIsNull(const QPointF &point)
bool operator!=(const QPointF &lhs, const QPointF &rhs)
QPointF operator*(const QPointF &point, qreal factor)
QPointF operator*(qreal factor, const QPointF &point)
QPointF operator+(const QPointF &point)
QPointF operator+(const QPointF &p1, const QPointF &p2)
QPointF operator-(const QPointF &p1, const QPointF &p2)
QPointF operator-(const QPointF &point)
QPointF operator/(const QPointF &point, qreal divisor)
QDataStream &operator<<(QDataStream &stream, const QPointF &point)
bool operator==(const QPointF &lhs, const QPointF &rhs)
QDataStream &operator>>(QDataStream &stream, QPointF &point)

Descripción detallada

Un punto se especifica mediante una coordenada x y una coordenada y a las que se puede acceder mediante las funciones x() y y(). Las coordenadas del punto se especifican utilizando números de coma flotante finita para mayor precisión. La función isNull() devuelve true si tanto x como y son 0,0. Las coordenadas pueden establecerse (o modificarse) utilizando las funciones setX() y setY(), o alternativamente las funciones rx() y ry() que devuelven referencias a las coordenadas (permitiendo la manipulación directa).

Dado un punto p, las declaraciones siguientes son todas equivalentes:

QPointF p;

p.setX(p.x() + 1.0);
p += QPointF(1.0, 0.0);
p.rx()++;

Un objeto QPointF también puede utilizarse como vector: La suma y la resta se definen como para los vectores (cada componente se suma por separado). Un objeto QPointF también se puede dividir o multiplicar por un int o un qreal.

Además, la clase QPointF proporciona un constructor que convierte un objeto QPoint en un objeto QPointF, y la correspondiente función toPoint() que devuelve una copia QPoint de este punto. Por último, los objetos QPointF pueden transmitirse por secuencias, así como compararse.

Véase también QPoint y QPolygonF.

Documentación de las funciones miembro

[constexpr noexcept] QPointF::QPointF()

Construye un punto nulo, es decir, con coordenadas (0.0, 0.0)

Véase también isNull().

[constexpr noexcept] QPointF::QPointF(const QPoint &point)

Construye una copia de point.

Véase también toPoint() y QPoint::toPointF().

[constexpr noexcept] QPointF::QPointF(qreal xpos, qreal ypos)

Construye un punto con las coordenadas dadas (xpos, ypos).

Véase también setX() y setY().

[static constexpr] qreal QPointF::dotProduct(const QPointF &p1, const QPointF &p2)

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
qreal dotProduct = QPointF::dotProduct(p, q);   // dotProduct becomes 26.01

Devuelve el producto punto de p1 y p2.

[static noexcept] QPointF QPointF::fromCGPoint(CGPoint point)

Crea un QRectF a partir del CGPoint point.

Véase también toCGPoint().

[noexcept] bool QPointF::isNull() const

Devuelve true si las coordenadas x e y son 0,0 (ignorando el signo); en caso contrario devuelve false.

[constexpr] qreal QPointF::manhattanLength() const

Devuelve la suma de los valores absolutos de x() y y(), tradicionalmente conocida como la "longitud Manhattan" del vector desde el origen hasta el punto.

Véase también QPoint::manhattanLength().

[constexpr noexcept] qreal &QPointF::rx()

Devuelve una referencia a la coordenada x de este punto.

El uso de una referencia permite manipular directamente x. Por ejemplo:

QPointF p(1.1, 2.5);
p.rx()--;   // p becomes (0.1, 2.5)

Véase también x() y setX().

[constexpr noexcept] qreal &QPointF::ry()

Devuelve una referencia a la coordenada y de este punto.

El uso de una referencia permite manipular directamente y. Por ejemplo:

QPointF p(1.1, 2.5);
p.ry()++;   // p becomes (1.1, 3.5)

Véase también y() y setY().

[constexpr noexcept] void QPointF::setX(qreal x)

Establece la coordenada x de este punto en la coordenada finita x dada.

Véase también x() y setY().

[constexpr noexcept] void QPointF::setY(qreal y)

Establece la coordenada y de este punto en la coordenada finita y dada.

Véase también y() y setX().

[noexcept] CGPoint QPointF::toCGPoint() const

Crea un CGPoint a partir de un QPointF.

Véase también fromCGPoint().

[constexpr] QPoint QPointF::toPoint() const

Redondea las coordenadas de este punto al entero más próximo y devuelve un objeto QPoint con las coordenadas redondeadas.

Véase también QPointF() y QPoint::toPointF().

[constexpr noexcept] QPointF QPointF::transposed() const

Devuelve un punto con las coordenadas x e y intercambiadas:

QPointF{1.0, 2.0}.transposed() // {2.0, 1.0}

Véase también x(), y(), setX() y setY().

[constexpr noexcept] qreal QPointF::x() const

Devuelve la coordenada x de este punto.

Véase también setX() y rx().

[constexpr noexcept] qreal QPointF::y() const

Devuelve la coordenada y de este punto.

Véase también setY() y ry().

[constexpr] QPointF &QPointF::operator*=(qreal factor)

Multiplica las coordenadas de este punto por el valor finito dado factor, y devuelve una referencia a este punto. Por ejemplo:

QPointF p(-1.1, 4.1);
p *= 2.5;    // p becomes (-2.75, 10.25)

Véase también operator/=().

[constexpr] QPointF &QPointF::operator+=(const QPointF &point)

Añade el point dado a este punto y devuelve una referencia a este punto. Por ejemplo:

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p += q;    // p becomes (2.1, 11.2)

Véase también operator-=().

[constexpr] QPointF &QPointF::operator-=(const QPointF &point)

Resta el point dado de este punto y devuelve una referencia a este punto. Por ejemplo:

QPointF p( 3.1, 7.1);
QPointF q(-1.0, 4.1);
p -= q;    // p becomes (4.1, 3.0)

Véase también operator+=().

[constexpr] QPointF &QPointF::operator/=(qreal divisor)

Divide x e y entre divisor y devuelve una referencia a este punto. Por ejemplo:

QPointF p(-2.75, 10.25);
p /= 2.5;           // p becomes (-1.1, 4.1)

divisor no debe ser cero ni NaN.

Véase también operator*=().

No miembros relacionados

[constexpr noexcept, since 6.8] bool qFuzzyCompare(const QPointF &p1, const QPointF &p2)

Devuelve true si p1 es aproximadamente igual a p2; en caso contrario devuelve false.

Esta función se introdujo en Qt 6.8.

Véase también qFuzzyIsNull.

[constexpr noexcept, since 6.8] bool qFuzzyIsNull(const QPointF &point)

Devuelve true si point es aproximadamente igual a un punto (0.0, 0.0).

Esta función se introdujo en Qt 6.8.

Véase también qFuzzyCompare.

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

Devuelve true si lhs es suficientemente diferente de rhs; en caso contrario devuelve false.

Atención: Esta función no comprueba la desigualdad estricta; en su lugar, utiliza una comparación difusa para comparar las coordenadas de los puntos.

Véase también qFuzzyCompare.

[constexpr] QPointF operator*(const QPointF &point, qreal factor)

Devuelve una copia del point dado , multiplicado por el factor finito dado.

Véase también QPointF::operator*=().

[constexpr] QPointF operator*(qreal factor, const QPointF &point)

Devuelve una copia del point dado, multiplicado por el factor finito dado.

Se trata de una función sobrecargada.

[constexpr] QPointF operator+(const QPointF &point)

Devuelve point sin modificar.

[constexpr] QPointF operator+(const QPointF &p1, const QPointF &p2)

Devuelve un objeto QPointF que es la suma de los puntos dados, p1 y p2; cada componente se suma por separado.

Véase también QPointF::operator+=().

[constexpr] QPointF operator-(const QPointF &p1, const QPointF &p2)

Devuelve un objeto QPointF que se forma restando p2 de p1; cada componente se resta por separado.

Véase también QPointF::operator-=().

[constexpr] QPointF operator-(const QPointF &point)

Devuelve un objeto QPointF que se forma cambiando el signo de cada componente del point dado.

Equivalente a QPointF(0,0) - point.

Se trata de una función sobrecargada.

[constexpr] QPointF operator/(const QPointF &point, qreal divisor)

Devuelve el objeto QPointF formado dividiendo cada componente del point dado por el divisor dado.

divisor no debe ser cero ni NaN.

Véase también QPointF::operator/=().

QDataStream &operator<<(QDataStream &stream, const QPointF &point)

Escribe el point 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 QPointF &lhs, const QPointF &rhs)

Devuelve true si lhs es aproximadamente igual a rhs; en caso contrario devuelve false.

Atención: Esta función no comprueba la igualdad estricta; en su lugar, utiliza una comparación difusa para comparar las coordenadas de los puntos.

Véase también qFuzzyCompare.

QDataStream &operator>>(QDataStream &stream, QPointF &point)

Lee un punto del stream dado en el point 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.