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

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

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