QPoint Class

Documentación de las funciones miembro

[constexpr noexcept] QPoint::QPoint()

Construye un punto nulo, es decir, con coordenadas (0, 0).

Véase también isNull().

[constexpr noexcept] QPoint::QPoint(int xpos, int ypos)

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

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

[static constexpr] int QPoint::dotProduct(const QPoint &p1, const QPoint &p2)

QPoint p( 3, 7);
QPoint q(-1, 4);
int dotProduct = QPoint::dotProduct(p, q);   // dotProduct becomes 25

Devuelve el producto punto de p1 y p2.

[constexpr noexcept] bool QPoint::isNull() const

Devuelve true si las coordenadas x e y son 0, en caso contrario devuelve false.

[constexpr] int QPoint::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. Por ejemplo:

QPoint oldPosition;

void MyWidget::mouseMoveEvent(QMouseEvent *event)
{
    QPoint point = event->pos() - oldPosition;
    if (point.manhattanLength() > 3){
        // the mouse has moved more than 3 pixels since the oldPosition
    }
}

Se trata de una aproximación útil y rápida de calcular a la longitud real:

double trueLength = std::sqrt(std::pow(x(), 2) + std::pow(y(), 2));

La tradición de la "longitud Manhattan" surge porque tales distancias se aplican a los viajeros que sólo pueden desplazarse por una cuadrícula rectangular, como las calles de Manhattan.

[constexpr noexcept] int &QPoint::rx()

Devuelve una referencia a la coordenada x de este punto.

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

QPoint p(1, 2);
p.rx()--;   // p becomes (0, 2)

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

[constexpr noexcept] int &QPoint::ry()

Devuelve una referencia a la coordenada y de este punto.

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

QPoint p(1, 2);
p.ry()++;   // p becomes (1, 3)

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

[constexpr noexcept] void QPoint::setX(int x)

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

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

[constexpr noexcept] void QPoint::setY(int y)

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

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

[noexcept] CGPoint QPoint::toCGPoint() const

Crea un CGPoint a partir de un QPoint.

Véase también QPointF::fromCGPoint().

[constexpr noexcept, since 6.4] QPointF QPoint::toPointF() const

Devuelve este punto como un punto con precisión de coma flotante.

Esta función se introdujo en Qt 6.4.

Véase también QPointF::toPoint().

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

Devuelve un punto con las coordenadas x e y intercambiadas:

QPoint{1, 2}.transposed() // {2, 1}

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

[constexpr noexcept] int QPoint::x() const

Devuelve la coordenada x de este punto.

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

[constexpr noexcept] int QPoint::y() const

Devuelve la coordenada y de este punto.

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

[constexpr] QPoint &QPoint::operator*=(double factor)

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

QPoint p(-1, 4);
p *= 2.5;    // p becomes (-3, 10)

Tenga en cuenta que el resultado se redondea al entero más próximo, ya que los puntos se mantienen como enteros. Utilice QPointF para obtener una precisión de coma flotante.

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

[constexpr] QPoint &QPoint::operator*=(float factor)

Multiplica las coordenadas de este punto por factor y devuelve una referencia a este punto.

Tenga en cuenta que el resultado se redondea al entero más cercano, ya que los puntos se mantienen como enteros. Utilice QPointF para obtener una precisión de coma flotante.

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

[constexpr] QPoint &QPoint::operator*=(int factor)

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

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

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

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

QPoint p( 3, 7);
QPoint q(-1, 4);
p += q;    // p becomes (2, 11)

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

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

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

QPoint p( 3, 7);
QPoint q(-1, 4);
p -= q;    // p becomes (4, 3)

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

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

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

QPoint p(-3, 10);
p /= 2.5;           // p becomes (-1, 4)

Tenga en cuenta que el resultado se redondea al entero más próximo, ya que los puntos se mantienen como enteros. Utilice QPointF para obtener precisión en coma flotante.

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