Главная · Все пространства имен · Все классы · Основные классы · Классы по группам · Модули · Функции

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

Класс QSize определяет размер двумерного объекта, используя целочисленную точность. Далее...

 #include <QSize>

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

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

• QSize ()
• QSize ( int width, int height )
• QSize boundedTo ( const QSize & otherSize ) const
• QSize expandedTo ( const QSize & otherSize ) const
• int height () const
• bool isEmpty () const
• bool isNull () const
• bool isValid () const
• int & rheight ()
• int & rwidth ()
• void scale ( int width, int height, Qt::AspectRatioMode mode )
• void scale ( const QSize & size, Qt::AspectRatioMode mode )
• void setHeight ( int height )
• void setWidth ( int width )
• void transpose ()
• int width () const
• QSize & operator*= ( qreal factor )
• QSize & operator+= ( const QSize & size )
• QSize & operator-= ( const QSize & size )
• QSize & operator/= ( qreal divisor )

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

• bool operator!= ( const QSize & s1, const QSize & s2 )
• const QSize operator* ( const QSize & size, qreal factor )
• const QSize operator* ( qreal factor, const QSize & size )
• const QSize operator+ ( const QSize & s1, const QSize & s2 )
• const QSize operator- ( const QSize & s1, const QSize & s2 )
• const QSize operator/ ( const QSize & size, qreal divisor )
• QDataStream & operator<< ( QDataStream & stream, const QSize & size )
• bool operator== ( const QSize & s1, const QSize & s2 )
• QDataStream & operator>> ( QDataStream & stream, QSize & size )

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

Класс QSize определяет размер двумерного объекта, используя целочисленную точность.

Размер определяется шириной - width() и высотой - height(). Он может быть установлен в конструкторе и изменён, используя функции setWidth(), setHeight(), или scale(), или используя арифметические операторы. Размер также может быть изменён непосредственно, получая ссылку на ширину и высоту, используя функции rwidth() и rheight(). В заключение, ширину и высоту можно поменять местами, используя функцию transpose().

Функция isValid() определяет, является ли размер действительным (действительный размер имеет и ширину, и высоту больше нуля). Функция isEmpty() возвращает true если либо ширина и высота меньше, либо равна нулю, в то время как функция isNull() возвращает true только если оба, и ширина и высота, равны нулю.

Используйте функцию expandedTo(), чтобы получить размер, который содержит максимальные высоту и ширину этого (this) размера и заданного размера. Аналогично, функция boundedTo() возвращает размер, который содержит минимальные высоту и ширину этого (this) размера и заданного размера.

Объект QSize может быть выведен в поток так же просто, как и сравниваться.

Смотрите также QSizeF, QPoint, и QRect.

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

QSize::QSize ()

Конструирует размер с недействительными шириной и высотой (т.е., isValid() возвращает false).

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

QSize::QSize ( int width, int height )

Конструирует размер с заданными шириной (width) и высотой (height).

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

QSize QSize::boundedTo ( const QSize & otherSize ) const

Возвращает размер содержащий минимальные ширину и высоту этого размера и заданного другого (otherSize) размера.

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

QSize QSize::expandedTo ( const QSize & otherSize ) const

Возвращает размер, содержащий максимальные ширину и высоту этого размера и заданного другого (otherSize) размера.

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

int QSize::height () const

Возвращает высоту.

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

bool QSize::isEmpty () const

Возвращает true если ширина и высота меньше или равны 0; в противном случае возвращает false.

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

bool QSize::isNull () const

Возвращает true если и ширина и высота равны 0; в противном случае возвращает false.

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

bool QSize::isValid () const

Возвращает true если и ширина и высота равны или больше 0; в противном случае возвращает false.

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

int & QSize::rheight ()

Возвращает ссылку на высоту.

Использование ссылки делает возможным работать с высотой непосредственно. Например:

 QSize size(100, 10);
 size.rheight() += 5;

 // размер станет (100,15)

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

int & QSize::rwidth ()

Возвращает ссылку на ширину.

Использование ссылки делает возможным работать с шириной непосредственно. Например:

 QSize size(100, 10);
 size.rwidth() += 20;

 // размер станет (120,10)

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

void QSize::scale ( int width, int height, Qt::AspectRatioMode mode )

Масштабирует размер к прямоугольнику с заданными шириной (width) и высотой (height), в соответствии с заданным режимом (mode):

• Если mode равен Qt::IgnoreAspectRatio, размер устанавливается в (width, height).
• Если mode равен Qt::KeepAspectRatio, текущий размер масштабируется до возможно большего прямоугольника внутри прямоугольной области (width, height), сохраняя пропорции.
• Если mode равен Qt::KeepAspectRatioByExpanding, текущий размер масштабируется до возможно меньшего прямоугольника снаружи области (width, height), сохраняя пропорции.

Пример:

 QSize t1(10, 12);
 t1.scale(60, 60, Qt::IgnoreAspectRatio);
 // t1 равно (60, 60)

 QSize t2(10, 12);
 t2.scale(60, 60, Qt::KeepAspectRatio);
 // t2 равно (50, 60)

 QSize t3(10, 12);
 t3.scale(60, 60, Qt::KeepAspectRatioByExpanding);
 // t3 равно (60, 72)

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

void QSize::scale ( const QSize & size, Qt::AspectRatioMode mode )

Это перегруженная функция, предоставленная для удобства.

Масштабирует размер к прямоугольнику с заданным размером (size), в соответствии с заданным режимом (mode):

void QSize::setHeight ( int height )

Устанавливает высоту в заданную (height).

Смотрите также rheight(), height() и setWidth().

void QSize::setWidth ( int width )

Устанавливает ширину в заданную (width).

Смотрите также rwidth(), width() и setHeight().

void QSize::transpose ()

Меняет местами значения ширины и высоты.

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

int QSize::width () const

Возвращает ширину.

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

QSize & QSize::operator*= ( qreal factor )

Умножает и ширину и высоту на заданный множитель (factor), и возвращает ссылку на размер.

Заметьте, что результат округлён до ближайшего целого.

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

QSize & QSize::operator+= ( const QSize & size )

Прибавляет заданный размер (size) к этому (this) размеру, и возвращает ссылку на этот размер. Например:

 QSize s( 3, 7);
 QSize r(-1, 4);
 s += r;

 // s станет (2,11)

QSize & QSize::operator-= ( const QSize & size )

Вычитает заданный размер (size) из этого (this) размера, и возвращает ссылку на этот размер. Например:

 QSize s( 3, 7);
 QSize r(-1, 4);
 s -= r;

 // s станет (4,3)

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

Делит и ширину, и высоту на заданный делитель (divisor), и возвращает ссылку на размер.

Заметьте, что результат округлён до ближайшего целого.

Смотрите также QSize::scale().

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

bool operator!= ( const QSize & s1, const QSize & s2 )

Это перегруженная функция, предоставленная для удобства.

Возвращает true если s1 и s2 неравны; в противном случае возвращает false.

const QSize operator* ( const QSize & size, qreal factor )

Это перегруженная функция, предоставленная для удобства.

Умножает заданный размер (size) на заданный множитель (factor), и возвращает результат, округлённый до ближайшего целого.

Смотрите также QSize::scale().

const QSize operator* ( qreal factor, const QSize & size )

Это перегруженная функция, предоставленная для удобства.

Умножает заданный размер (size) на заданный множитель (factor), и возвращает результат, округлённый до ближайшего целого.

const QSize operator+ ( const QSize & s1, const QSize & s2 )

Это перегруженная функция, предоставленная для удобства.

Возвращает сумму s1 и s2; каждый компонент добавляется отдельно.

const QSize operator- ( const QSize & s1, const QSize & s2 )

Это перегруженная функция, предоставленная для удобства.

Возвращает разность s2 и s1; каждый компонент вычитается отдельно.

const QSize operator/ ( const QSize & size, qreal divisor )

Это перегруженная функция, предоставленная для удобства.

Делит заданный размер (size) на заданный делитель (divisor), и возвращает результат, округлённый до ближайшего целого.

Смотрите также QSize::scale().

QDataStream & operator<< ( QDataStream & stream, const QSize & size )

Это перегруженная функция, предоставленная для удобства.

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

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

bool operator== ( const QSize & s1, const QSize & s2 )

Это перегруженная функция, предоставленная для удобства.

Возвращает true если s1 и s2 равны; в противном случае возвращает false.

QDataStream & operator>> ( QDataStream & stream, QSize & size )

Это перегруженная функция, предоставленная для удобства.

Читает размер из потока stream в заданный размер size и возвращает ссылку на поток.

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