Класс 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(), которая возвращает копию 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)

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

[static, since 5.1] 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, since 5.8] 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(), традиционно называемую «маньхаттэнской длиной» вектора от начала координат до точки.

См. также 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().

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

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

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

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

QPoint QPointF::toPoint() const

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

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

[since 5.14] 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)

divisor не должен быть равен нулю или NaN.

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