Класс QSizePolicy

Класс QSizePolicy — атрибут макета, описывающий политику изменения размеров по горизонтали и вертикали. Подробнее...

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

Типы публичного интерфейса

Публичные функции

Связанные внешние функции

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

Класс QSizePolicy — атрибут макета, описывающий политику изменения размеров по горизонтали и вертикали.

Политика изменения размеров виджета определяет его поведение при изменении размеров и влияет на то, как виджет обрабатывает движок макета. Каждый виджет возвращает QSizePolicy, описывающую предпочтительную политику изменения размеров по горизонтали и вертикали при размещении в макете. Можно изменить эти политики для конкретного виджета, изменив свойство QWidget::sizePolicy.

QSizePolicy содержит два независимых значения QSizePolicy::Policy и два коэффициента растяжения; одно описывает политику изменения горизонтальных размеров виджета, а другое — политику изменения вертикальных размеров. Также он содержит флаг, указывающий, связаны ли высота и ширина его предпочтительного размера.

Политики по горизонтали и вертикали можно установить в конструкторе и изменить с помощью функций setHorizontalPolicy() и setVerticalPolicy(). Коэффициенты растяжения можно установить с помощью функций setHorizontalStretch() и setVerticalStretch(). Флаг, указывающий, зависит ли размер, рекомендованный функцией sizeHint() виджета, от ширины (например, строка меню или метка с переносными словами), можно установить с помощью функции setHeightForWidth().

Текущие политики изменения размеров и коэффициенты растяжения можно получить с помощью функций horizontalPolicy(), verticalPolicy(), horizontalStretch() и verticalStretch(). В качестве альтернативы, используйте функцию transpose() для перестановки горизонтальных и вертикальных политик и коэффициентов растяжения. Функция hasHeightForWidth() возвращает текущее состояние флага, указывающего на зависимости размера подсказки.

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

В конечном итоге класс QSizePolicy предоставляет операторы для сравнения этой политики изменения размеров с заданной политикой, а также оператор QVariant для хранения этой QSizePolicy в качестве объекта QVariant.

См. также QSize, QWidget::sizeHint(), QWidget::sizePolicy и QLayoutItem::sizeHint().

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

Перечисление QSizePolicy::ControlTypeфлаги QSizePolicy::ControlTypes

Это перечисление определяет различные типы виджетов с точки зрения взаимодействия с макетом:

Этот перечисление был введён или изменён в Qt 4.3.

Тип ControlTypes — это синоним для QFlags<ControlType>. Он хранит логическое ИЛИ комбинацию значений ControlType.

См. также setControlType() и controlType().

перечисление QSizePolicy::Policy

Это перечисление описывает различные типы размеров по каждой размерности, используемые при создании QSizePolicy.

См. также PolicyFlag, setHorizontalPolicy() и setVerticalPolicy().

перечисление QSizePolicy::PolicyFlag

Эти флаги объединяются для формирования различных значений Policy:

См. также Policy.

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

QSizePolicy::QSizePolicy()

Создаёт объект QSizePolicy с горизонтальными и вертикальными политиками Fixed.

Политики могут быть изменены с помощью функций setHorizontalPolicy() и setVerticalPolicy(). Используйте функцию setHeightForWidth(), если предпочтительная высота виджета зависит от ширины виджета (например, QLabel с переходом на новую строку).

См. также setHorizontalStretch() и setVerticalStretch().

QSizePolicy::QSizePolicy(Policy horizontal, Policy vertical, ControlType type = DefaultType)

Создаёт объект QSizePolicy с заданными горизонтальными и вертикальными политиками и указанным типом управления.

Используйте setHeightForWidth(), если предпочтительная высота виджета зависит от ширины виджета (например, QLabel с переходом на новую строку).

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

См. также setHorizontalStretch(), setVerticalStretch() и controlType().

ControlType QSizePolicy::controlType() const

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

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

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

Qt::Orientations QSizePolicy::expandingDirections() const

Возвращает, может ли виджет использовать больше места, чем указано функцией QWidget::sizeHint().

Значение Qt::Horizontal или Qt::Vertical означает, что виджет может увеличиваться по горизонтали или вертикали (т.е. горизонтальная или вертикальная политика равна Expanding или MinimumExpanding), а Qt::Horizontal | Qt::Vertical означает, что он может увеличиваться по обеим осям.

См. также horizontalPolicy() и verticalPolicy().

bool QSizePolicy::hasHeightForWidth() const

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

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

bool QSizePolicy::hasWidthForHeight() const

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

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

Policy QSizePolicy::horizontalPolicy() const

Возвращает горизонтальную составляющую политики размера.

См. также setHorizontalPolicy(), verticalPolicy(), и horizontalStretch().

int QSizePolicy::horizontalStretch() const

Возвращает коэффициент горизонтального растяжения политики размеров.

См. также setHorizontalStretch(), verticalStretch(), и horizontalPolicy().

bool QSizePolicy::retainSizeWhenHidden() const

Возвращает значение, указывающее, следует ли макету сохранять размер виджета при его скрытии. По умолчанию это false.

Данная функция была добавлена в Qt 5.2.

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

void QSizePolicy::setControlType(ControlType type)

Устанавливает тип управления, связанный с виджетом, для которого применяется эта политика размеров, на type.

Тип управления определяет тип виджета, для которого применяется эта политика размеров. Он используется некоторыми стилями, в частности QMacStyle, для вставки правильных отступов между виджетами. Например, рекомендации macOS Aqua предписывают, чтобы кнопки были разделены 12 пикселями, в то время как вертикально расположенные радиокнопки требуют только 6 пикселей.

Данная функция была добавлена в Qt 4.3.

См. также controlType() и QStyle::layoutSpacing().

void QSizePolicy::setHeightForWidth(bool dependent)

Устанавливает флаг, определяющий, зависит ли предпочтительная высота виджета от его ширины, на dependent.

См. также hasHeightForWidth() и setWidthForHeight().

void QSizePolicy::setHorizontalPolicy(Policy policy)

Устанавливает горизонтальную составляющую на заданную policy.

См. также horizontalPolicy(), setVerticalPolicy(), и setHorizontalStretch().

void QSizePolicy::setHorizontalStretch(int stretchFactor)

Устанавливает коэффициент горизонтального растяжения политики размеров на заданный stretchFactor. stretchFactor должен быть в диапазоне [0,255].

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

См. также horizontalStretch(), setVerticalStretch(), и setHorizontalPolicy().

void QSizePolicy::setRetainSizeWhenHidden(bool retainSize)

Устанавливает, следует ли макету сохранять размер виджета при его скрытии. Если retainSize равно true, макет не будет изменён при скрытии виджета.

Данная функция была добавлена в Qt 5.2.

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

void QSizePolicy::setVerticalPolicy(Policy policy)

Устанавливает вертикальную составляющую на заданную policy.

См. также verticalPolicy(), setHorizontalPolicy(), и setVerticalStretch().

void QSizePolicy::setVerticalStretch(int stretchFactor)

Устанавливает коэффициент вертикального растяжения политики размеров на заданный stretchFactor. stretchFactor должен быть в диапазоне [0,255].

Когда два виджета расположены рядом в вертикальном макете, установка коэффициента вертикального растяжения виджета сверху на 2, а виджета снизу на 1 гарантирует, что виджет сверху всегда будет в два раза больше виджета снизу.

См. также verticalStretch(), setHorizontalStretch(), и setVerticalPolicy().

void QSizePolicy::setWidthForHeight(bool dependent)

Устанавливает флаг, определяющий, зависит ли ширина виджета от его высоты, на dependent.

Это поддерживается только для подклассов QGraphicsLayout. Невозможно иметь макет с ограничениями и высоты по ширине, и ширины по высоте одновременно.

См. также hasWidthForHeight() и setHeightForWidth().

void QSizePolicy::transpose()

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

Policy QSizePolicy::verticalPolicy() const

Возвращает вертикальную составляющую политики размеров.

См. также setVerticalPolicy(), horizontalPolicy(), и verticalStretch().

int QSizePolicy::verticalStretch() const

Возвращает коэффициент вертикального растяжения политики размеров.

См. также setVerticalStretch(), horizontalStretch(), и verticalPolicy().

QSizePolicy::operator QVariant() const

Возвращает QVariant, хранящий эту QSizePolicy.

bool QSizePolicy::operator!=(const QSizePolicy &other) const

Возвращает true, если эта политика отличается от other; в противном случае возвращает false.

См. также operator==().

bool QSizePolicy::operator==(const QSizePolicy &other) const

Возвращает true, если эта политика равна other; в противном случае возвращает false.

См. также operator!=().