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

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