Класс QPointF

Класс 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()

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

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

QPointF::QPointF(const QPoint &point)

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

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

QPointF::QPointF(qreal xpos, qreal ypos)

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

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

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

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().

QPoint QPointF::toPoint() const

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

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

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*=().