Класс QSize

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

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

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

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

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

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

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

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

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

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

Документация по функциям-членам

[since 5.14] QSize QSize::shrunkBy(QMargins margins) const

Возвращает размер, полученный в результате уменьшения этого размера на margins.

Эта функция была добавлена в Qt 5.14.

См. также grownBy().

[since 5.14] QSize QSize::grownBy(QMargins margins) const

Возвращает размер, полученный в результате увеличения этого размера на margins.

Эта функция была добавлена в Qt 5.14.

См. также shrunkBy().

QSize::QSize(int width, int height)

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

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

QSize::QSize()

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

См. также isValid().

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;

// size becomes (100,15)

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

int &QSize::rwidth()

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

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

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

// size becomes (120,10)

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

void QSize::scale(int width, int height, Qt::AspectRatioMode 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 is (60, 60)

QSize t2(10, 12);
t2.scale(60, 60, Qt::KeepAspectRatio);
// t2 is (50, 60)

QSize t3(10, 12);
t3.scale(60, 60, Qt::KeepAspectRatioByExpanding);
// t3 is (60, 72)

См. также setWidth(), setHeight() и scaled().

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

Это перегруженный метод.

Масштабирует размер до прямоугольника с заданным размером, в соответствии со специфицированным режимом.

[since 5.0] QSize QSize::scaled(int width, int height, Qt::AspectRatioMode mode) const

Возвращает размер, масштабированный до прямоугольника с заданной шириной и высотой, в соответствии со специфицированным режимом.

Эта функция была добавлена в Qt 5.0.

См. также scale().

[since 5.0] QSize QSize::scaled(const QSize &s, Qt::AspectRatioMode mode) const

Это перегруженный метод.

Возвращает размер, масштабированный до прямоугольника с заданным размером s, в соответствии со специфицированным режимом.

Эта функция была добавлена в Qt 5.0.

void QSize::setHeight(int height)

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

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

void QSize::setWidth(int width)

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

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

[since 5.8] CGSize QSize::toCGSize() const

Создаёт CGSize из QSize.

Эта функция была добавлена в Qt 5.8.

См. также QSizeF::fromCGSize().

void QSize::transpose()

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

См. также setWidth(), setHeight() и transposed().

[since 5.0] QSize QSize::transposed() const

Возвращает QSize со значениями ширины и высоты, поменянными местами.

Эта функция была добавлена в Qt 5.0.

См. также transpose().

int QSize::width() const

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

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

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

Это перегруженный метод.

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

Обратите внимание, что результат округляется до ближайшего целого числа.

См. также scale().

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

Добавляет заданный размер к текущему размеру и возвращает ссылку на этот размер. Например:

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

// s becomes (2,11)

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

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

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

// s becomes (4,3)

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

Это перегруженный метод.

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

Обратите внимание, что результат округляется до ближайшего целого числа.

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