Главная · Все классы · Все функции · Обзоры

Описание класса QPointF
[Модуль QtCore]

Класс QPointF описывает точку на плоскости, используя точность плавающей точкой. Далее...

 #include <QPointF>

• Список всех членов, включая унаследованные

Открытые функции

Связанные нечлены класса

Подробное описание

Класс QPointF описывает точку на плоскости, используя точность плавающей точкой.

Точка определяется координатой x и координатой y, которые могут быть доступны используя функции x() и y(). Координаты точки определяются используя точность чисел с плавающей точкой. Функция isNull() возвращает истину если и 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(), которая возвращает копию типа QPoint этой (this) точки. В заключение, объект QPointF может быть выведен в поток так же просто как и сравниваться.

Смотрите также QPoint и QPolygon.

Описание функций-членов

QPointF::QPointF ()

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

Смотрите также isNull().

QPointF::QPointF ( const QPoint & point )

Конструктор копирования (Конструирует копию точки point).

Смотрите также toPoint().

QPointF::QPointF ( qreal x, qreal y )

Конструирует точку с заданными координатами (x, y).

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

bool QPointF::isNull () const

Возвращает истину если обе координаты, х и у, равны 0.0, в противном случае возвращает ложь.

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 станет (0.1, 2.5)

Смотрите также x() и setX().

qreal & QPointF::ry ()

Возвращает ссылку на координату y, этой точки.

Использование ссылки делает возможным прямую манипуляцию над координатой y. Например:

 QPointF p(1.1, 2.5);
 p.ry()++;   // p станет (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 станет (-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 станет (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 станет (4.1, 3.0)

Смотрите также operator+=().

QPointF & QPointF::operator/= ( qreal divisor )

Делит обе координаты, x и y, на заданный делитель divisor, и возвращает ссылку на эту точку. Например:

 QPointF p(-2.75, 10.25);
 p /= 2.5;           // p станет (-1.1, 4.1)

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

Связанные нечлены класса

bool operator!= ( const QPointF & p1, const QPointF & p2 )

Возвращает истину если p1 не равно p2; в противном случае возвращает ложь.

const QPointF operator* ( const QPointF & point, qreal factor )

Возвращает копию точки point, умноженной на factor.

Смотрите также QPointF::operator*=().

const QPointF operator* ( qreal factor, const QPointF & point )

Это перегруженная функция.

Возвращает копию точки point, умноженной на factor.

const QPointF operator+ ( const QPointF & p1, const QPointF & p2 )

Возвращает объект QPointF, который является суммой точек, p1 и p2; каждый компонент добавляется отдельно.

Смотрите также QPointF::operator+=().

const QPointF operator- ( const QPointF & p1, const QPointF & p2 )

Возвращает объект QPointF, который получается вычитанием p1 из p2; каждый компонент вычитается отдельно.

Смотрите также QPointF::operator-=().

const QPointF operator- ( const QPointF & point )

Это перегруженная функция.

Возвращает объект QPointF, который получается изменением знака обоих компонентов точки point.

Эквивалентно QPointF(0,0) - point.

const QPointF operator/ ( const QPointF & point, qreal divisor )

Возвращает QPointF получаемый делением обоих компонентов точки point на заданный делитель divisor.

Смотрите также QPointF::operator/=().

QDataStream & operator<< ( QDataStream & stream, const QPointF & point )

Записывает точку point в заданный поток stream и возвращает ссылку на поток.

Смотрите также Формат операторов QDataStream.

bool operator== ( const QPointF & p1, const QPointF & p2 )

Возвращает истину если p1 равно p2 ; в противном случае возвращает ложь.

QDataStream & operator>> ( QDataStream & stream, QPointF & point )

Читает точку из потока stream в заданную точку point и возвращает ссылку на поток.

Смотрите также Формат операторов QDataStream.