En esta página

QPointF Class

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

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

Nota: Todas las funciones de esta clase son reentrantes.

Comparaciones de QPointF

CategoríaTipos comparables
igualdadQPointF
igualdadQPoint.

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 finitos para garantizar la precisión. La función ` isNull()` devuelve ` true ` si tanto `x` como `y` se establecen en 0,0. Las coordenadas se pueden establecer (o modificar) mediante las funciones ` setX()` y ` setY()`, o bien mediante las funciones ` rx()` y ` ry()`, que devuelven referencias a las coordenadas (lo que permite su manipulación directa).

Dado un punto p, las siguientes expresiones 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 puede dividirse o multiplicarse por un ` int ` o un ` qreal`.

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

Véase también QPoint y QPolygonF.

Documentación de las funciones miembro

[constexpr noexcept] QPointF::QPointF()

Crea un punto nulo, es decir, con coordenadas (0,0; 0,0)

Véase también isNull().

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

Crea una copia del objeto point especificado.

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

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

Crea un punto con las coordenadas indicadas (xpos, ypos).

Véanse 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 escalar de p1 y p2.

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

Crea un objeto « QRectF » a partir de «CGPoint» point.

Véase también toCGPoint().

[noexcept] bool QPointF::isNull() const

Devuelve ` true ` si las coordenadas x e y están establecidas en 0,0 (sin tener en cuenta el signo); en caso contrario, devuelve ` false`.

[constexpr] qreal QPointF::manhattanLength() const

Devuelve la suma de los valores absolutos de x() y y(), lo que tradicionalmente se conoce como la «longitud de Manhattan» del vector que va del origen al 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 la coordenada 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 la coordenada 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 indicada.

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 indicada.

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 cercano 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 objeto « point » especificado 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 » indicado 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 tanto x como y por el valor dado 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)

El valor de « divisor » no debe ser cero ni NaN.

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

Elementos 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 lo suficientemente diferente de « rhs »; en caso contrario, devuelve « false ».

Advertencia: Esta función no comprueba la desigualdad estricta; en su lugar, utiliza una comparación aproximada 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.

Esta es una función sobrecargada.

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

Devuelve « point » sin modificaciones.

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

Devuelve un objeto ` QPointF ` que es la suma de los puntos indicados: ` 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 obtiene 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 crea cambiando el signo de cada componente del objeto ` point` dado.

Equivalente a ` QPointF(0,0) - point`.

Esta es una función sobrecargada.

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

Devuelve el objeto ` QPointF ` obtenido al dividir cada componente del ` point ` dado por el ` divisor` dado.

El objeto ` divisor ` no debe ser cero ni NaN.

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

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

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

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

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

Véase también qFuzzyCompare.

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

Lee un punto del archivo « stream » especificado en el archivo « point » 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.