Класс QPoint

Класс QPoint определяет точку на плоскости с использованием целочисленной точности. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются повторно входящими.

Открытые функции

Статические открытые члены

Связанные нечлены

Подробное описание

Точка задается координатой x и координатой y, к которым можно получить доступ, используя функции x() и y(). Функция isNull() возвращает true , если обе координаты x и y установлены в 0. Координаты можно задать (или изменить) с помощью функций setX() и setY() или же функций rx() и ry(), которые возвращают ссылки на координаты (что позволяет напрямую их изменять).

Учитывая точку p, следующие утверждения все эквивалентны:

QPoint p;

p.setX(p.x() + 1);
p += QPoint(1, 0);
p.rx()++;

Объект QPoint также может использоваться как вектор: сложение и вычитание определены как для векторов (каждая компонента добавляется отдельно). Объект QPoint также может быть разделен или умножен на int или qreal.

Кроме того, класс QPoint предоставляет функцию manhattanLength(), которая дает недорогую аппроксимацию длины объекта QPoint, интерпретируемого как вектор. Наконец, объекты QPoint могут быть переданы и сравнены.

См. также QPointF и QPolygon.

Документация по функциям-членам

QPoint::QPoint(int xpos, int ypos)

Конструирует точку с заданными координатами (xpos, ypos).

См. также setX() и setY().

QPoint::QPoint()

Конструирует нулевую точку, т.е. с координатами (0, 0)

См. также isNull().

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

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

Возвращает скалярное произведение p1 и p2.

Эта функция была введена в Qt 5.1.

bool QPoint::isNull() const

Возвращает true , если обе координаты x и y установлены в 0, в противном случае возвращает false.

int QPoint::manhattanLength() const

Возвращает сумму абсолютных значений x() и y(), традиционно известную как «махагоннская длина» вектора от начала координат до точки. Например:

QPoint oldPosition;

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

Это полезное и быстро вычисляемое приближение к истинной длине:

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

Традиция «махагоннской длины» возникает из-за того, что такие расстояния применимы к путешественникам, которые могут перемещаться только по прямоугольной сетке, например, по улицам Манхэттена.

int &QPoint::rx()

Возвращает ссылку на координату x этой точки.

Использование ссылки позволяет напрямую манипулировать x. Например:

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

См. также x() и setX().

int &QPoint::ry()

Возвращает ссылку на координату y этой точки.

Использование ссылки позволяет напрямую манипулировать y. Например:

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

См. также y() и setY().

void QPoint::setX(int x)

Устанавливает координату x этой точки на заданную координату x.

См. также x() и setY().

void QPoint::setY(int y)

Устанавливает координату y этой точки заданной координатой y.

См. также y() и setX().

[since 5.8] CGPoint QPoint::toCGPoint() const

Создает CGPoint из QPoint.

Эта функция была добавлена в Qt 5.8.

См. также QPointF::fromCGPoint().

[since 5.14] QPoint QPoint::transposed() const

Возвращает точку с поменянными местами координатами x и y:

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

Эта функция была добавлена в Qt 5.14.

См. также x(), y(), setX(), и setY().

int QPoint::x() const

Возвращает координату x этой точки.

См. также setX() и rx().

int QPoint::y() const

Возвращает координату y этой точки.

См. также setY() и ry().

QPoint &QPoint::operator*=(float factor)

Умножает координаты этой точки на заданный factor и возвращает ссылку на эту точку.

Обратите внимание, что результат округляется до ближайшего целого числа, так как точки хранятся как целые числа. Используйте QPointF для точности с плавающей точкой.

См. также operator/=().

QPoint &QPoint::operator*=(double factor)

Умножает координаты этой точки на заданный factor и возвращает ссылку на эту точку. Например:

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

Обратите внимание, что результат округляется до ближайшего целого числа, так как точки хранятся как целые числа. Используйте QPointF для точности с плавающей точкой.

См. также operator/=().

QPoint &QPoint::operator*=(int factor)

Умножает координаты этой точки на заданный factor и возвращает ссылку на эту точку.

См. также operator/=().

QPoint &QPoint::operator+=(const QPoint &point)

Добавляет заданную point к этой точке и возвращает ссылку на эту точку. Например:

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

См. также operator-=().

QPoint &QPoint::operator-=(const QPoint &point)

Вычитает заданную point из этой точки и возвращает ссылку на эту точку. Например:

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

См. также operator+=().

QPoint &QPoint::operator/=(qreal divisor)

Это перегруженная функция.

Делит x и y на заданный divisor и возвращает ссылку на эту точку. Например:

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

Обратите внимание, что результат округляется до ближайшего целого числа, так как точки хранятся как целые числа. Используйте QPointF для точности с плавающей точкой.

См. также operator*=().