Класс QPointF

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

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

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

Публичные функции

Статические публичные члены

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

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

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

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

QPointF p;

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

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

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

См. также QPoint и QPolygonF.

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

QPointF::QPointF(qreal xpos, qreal ypos)

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

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

QPointF::QPointF(const QPoint &point)

Создаёт копию заданной точки point.

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

QPointF::QPointF()

Создаёт нулевую точку, т.е. с координатами (0.0, 0.0)

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

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

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

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

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

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

Создаёт QRectF из CGPoint point.

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

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

bool QPointF::isNull() const

Возвращает true если обе координаты x и y установлены в 0.0 (не учитывая знак); в противном случае возвращает false.

qreal QPointF::manhattanLength() const

Возвращает сумму абсолютных значений x() и y(), традиционно известную как "манхэттенская длина" вектора от начала координат до точки.

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

См. также QPoint::manhattanLength().

qreal &QPointF::rx()

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

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

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

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

qreal &QPointF::ry()

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

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

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

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

void QPointF::setX(qreal x)

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

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

void QPointF::setY(qreal y)

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

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

CGPoint QPointF::toCGPoint() const

Создаёт CGPoint из QPointF.

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

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

QPoint QPointF::toPoint() const

Округляет координаты этой точки до ближайшего целого числа и возвращает объект QPoint с округленными координатами.

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

QPointF QPointF::transposed() const

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

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

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

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

qreal QPointF::x() const

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

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

qreal QPointF::y() const

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

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

QPointF &QPointF::operator*=(qreal factor)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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