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

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