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

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