Класс QBoxLayout

Класс QBoxLayout выстраивает дочерние виджеты горизонтально или вертикально. Подробнее...

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

Открытые типы

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

Переопределённые открытые функции

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

QBoxLayout занимает предоставленное ему пространство (от родительского макета или от parentWidget()), делит его на ряд блоков и заставляет каждый управляемый виджет заполнять один блок.

Если ориентация QBoxLayout равна Qt::Horizontal, блоки размещаются в ряд с соответствующими размерами. Каждый виджет (или другой блок) получит как минимум свой минимальный размер и как максимум свой максимальный размер. Любое лишнее пространство распределяется в соответствии с коэффициентами растяжения (подробнее об этом ниже).

Если ориентация QBoxLayout равна Qt::Vertical, блоки размещаются в столбец, опять же с соответствующими размерами.

Проще всего создать QBoxLayout, используя один из вспомогательных классов, например, QHBoxLayout (для блоков Qt::Horizontal) или QVBoxLayout (для блоков Qt::Vertical). Можно также использовать конструктор QBoxLayout напрямую, указав его направление как LeftToRight, RightToLeft, TopToBottom или BottomToTop.

Если QBoxLayout не является макетом верхнего уровня (т. е. он не управляет всей областью и дочерними элементами виджета), его необходимо добавить в родительский макет, прежде чем можно будет что-либо с ним сделать. Обычно макет добавляется вызовом parentLayout->addLayout().

После этого можно добавлять блоки в QBoxLayout, используя одну из четырех функций:

• addWidget() для добавления виджета в QBoxLayout и установки коэффициента растяжения виджета. (Коэффициент растяжения распространяется вдоль ряда блоков.)
• addSpacing() для создания пустого блока; это одна из функций, которые используются для создания красивых и просторных диалоговых окон. См. ниже способы установки полей.
• addStretch() для создания пустого, растягиваемого блока.
• addLayout() для добавления блока, содержащего другой QLayout, в ряд и установки коэффициента растяжения этого макета.

Используйте insertWidget(), insertSpacing(), insertStretch() или insertLayout() для вставки блока в указанную позицию в макете.

QBoxLayout также включает две ширины полей:

• setContentsMargins() устанавливает ширину внешней границы с каждой стороны виджета. Это ширина зарезервированного пространства вдоль каждой из четырех сторон QBoxLayout.
• setSpacing() устанавливает ширину между соседними блоками. (Можно использовать addSpacing() для получения большего пространства в определенном месте.)

Значение по умолчанию для отступа задаётся стилем. По умолчанию большинство стилей Qt устанавливают отступ 9 для дочерних виджетов и 11 для окон. Отступ по умолчанию равен ширине отступа для верхнего уровня макета или отступу родительского макета.

Чтобы удалить виджет из макета, вызовите removeWidget(). Вызов QWidget::hide() для виджета также эффективно удаляет виджет из макета до вызова QWidget::show().

Практически всегда следует использовать QVBoxLayout и QHBoxLayout, а не QBoxLayout из-за удобных конструкторов.

См. также QGridLayout, QStackedLayout и Управление макетами.

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

enum QBoxLayout::Direction

Этот тип используется для определения направления макета типа «коробки».

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

QBoxLayout::QBoxLayout(QBoxLayout::Direction dir, QWidget *parent = nullptr)

Создаёт новый QBoxLayout с направлением dir и родительским виджетом parent.

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

[virtual] QBoxLayout::~QBoxLayout()

Удаляет этот макет типа «коробки».

Виджеты макета не удаляются.

[override virtual] void QBoxLayout::addItem(QLayoutItem *item)

Переопределяет: QLayout::addItem(QLayoutItem *item).

void QBoxLayout::addLayout(QLayout *layout, int stretch = 0)

Добавляет layout в конец коробки с коэффициентом растяжения stretch.

См. также insertLayout(), addItem() и addWidget().

void QBoxLayout::addSpacerItem(QSpacerItem *spacerItem)

Добавляет spacerItem в конец этого макета типа «коробки».

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

См. также addSpacing() и addStretch().

void QBoxLayout::addSpacing(int size)

Добавляет нерастягиваемое пространство (QSpacerItem) размером size в конец этого макета типа «коробки». QBoxLayout предоставляет значения по умолчанию для отступа и интервала. Эта функция добавляет дополнительное пространство.

См. также insertSpacing(), addItem() и QSpacerItem.

void QBoxLayout::addStretch(int stretch = 0)

Добавляет растягиваемое пространство (QSpacerItem) с нулевым минимальным размером и коэффициентом растяжения stretch в конец этого макета типа «коробки».

См. также insertStretch(), addItem() и QSpacerItem.

void QBoxLayout::addStrut(int size)

Ограничивает перпендикулярный размер коробки (например, высоту, если коробка имеет направление LeftToRight) минимальной величиной size. Другие ограничения могут увеличить это предельное значение.

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

void QBoxLayout::addWidget(QWidget *widget, int stretch = 0, Qt::Alignment alignment = Qt::Alignment())

Добавляет widget в конец этого макета типа «коробки» с коэффициентом растяжения stretch и выравниванием alignment.

Коэффициент растяжения применяется только в направлении direction QBoxLayout и относится к другим коробкам и виджетам в этом QBoxLayout. Виджеты и коробки с более высокими коэффициентами растяжения растут больше.

Если коэффициент растяжения равен 0, и ничего другого в QBoxLayout не имеет коэффициента растяжения, превышающего ноль, пространство распределяется в соответствии со значением QWidget:sizePolicy() каждого вовлечённого виджета.

Выравнивание определяется значением alignment. Значение по умолчанию для выравнивания равно 0, что означает, что виджет заполняет всю ячейку.

См. также insertWidget(), addItem(), addLayout(), addStretch(), addSpacing() и addStrut().

[override virtual] int QBoxLayout::count() const

Переопределяет: QLayout::count() const.

QBoxLayout::Direction QBoxLayout::direction() const

Возвращает направление коробки. addWidget() и addSpacing() работают в этом направлении; растяжение растягивается в этом направлении.

См. также setDirection(), QBoxLayout::Direction, addWidget() и addSpacing().

[override virtual] Qt::Orientations QBoxLayout::expandingDirections() const

Переопределяет: QLayout::expandingDirections() const.

[override virtual] bool QBoxLayout::hasHeightForWidth() const

Переопределяет: QLayoutItem::hasHeightForWidth() const.

[override virtual] int QBoxLayout::heightForWidth(int w) const

Переопределяет: QLayoutItem::heightForWidth(int ) const.

void QBoxLayout::insertItem(int index, QLayoutItem *item)

Вставляет item в этот макет типа «коробки» в позиции index. Если index отрицательно, элемент добавляется в конец.

См. также addItem(), insertWidget(), insertLayout(), insertStretch() и insertSpacing().

void QBoxLayout::insertLayout(int index, QLayout *layout, int stretch = 0)

Вставляет layout в позицию index с коэффициентом растяжения stretch. Если index отрицательно, макет добавляется в конец.

layout становится дочерним элементом макета типа «коробки».

См. также addLayout() и insertItem().

void QBoxLayout::insertSpacerItem(int index, QSpacerItem *spacerItem)

Вставляет spacerItem в позицию index с нулевым минимальным размером и коэффициентом растяжения. Если index отрицательно, пространство добавляется в конец.

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

См. также addSpacerItem(), insertStretch() и insertSpacing().

void QBoxLayout::insertSpacing(int index, int size)

Вставляет нерастягиваемое пространство (QSpacerItem) в позицию index размером size. Если index отрицательно, пространство добавляется в конец.

Макет типа «коробки» имеет значения по умолчанию для отступа и интервала. Эта функция добавляет дополнительное пространство.

См. также addSpacing(), insertItem() и QSpacerItem.

void QBoxLayout::insertStretch(int index, int stretch = 0)

Вставляет растягиваемое пространство (QSpacerItem) в позицию index с нулевым минимальным размером и коэффициентом растяжения stretch. Если index отрицательно, пространство добавляется в конец.

См. также addStretch(), insertItem() и QSpacerItem.

void QBoxLayout::insertWidget(int index, QWidget *widget, int stretch = 0, Qt::Alignment alignment = Qt::Alignment())

Вставляет widget в позицию index со значением коэффициента растяжения stretch и выравниванием alignment. Если index отрицательно, виджет добавляется в конец.

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

Если коэффициент растяжения равен 0, и ничего больше в QBoxLayout не имеет коэффициента растяжения больше нуля, пространство распределяется в соответствии с QWidget:sizePolicy() каждого участвующего виджета.

Выравнивание задаётся значением alignment. По умолчанию выравнивание равно 0, что означает, что виджет заполняет всю ячейку.

См. также addWidget() и insertItem().

[override virtual] void QBoxLayout::invalidate()

Переопределяет: QLayout::invalidate().

Сбрасывает кэшированную информацию.

[override virtual] QLayoutItem *QBoxLayout::itemAt(int index) const

Переопределяет: QLayout::itemAt(int index) const.

[override virtual] QSize QBoxLayout::maximumSize() const

Переопределяет: QLayout::maximumSize() const.

[override virtual] int QBoxLayout::minimumHeightForWidth(int w) const

Переопределяет: QLayoutItem::minimumHeightForWidth(int w) const.

[override virtual] QSize QBoxLayout::minimumSize() const

Переопределяет: QLayout::minimumSize() const.

void QBoxLayout::setDirection(QBoxLayout::Direction direction)

Устанавливает направление этого макета на direction.

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

[override virtual] void QBoxLayout::setGeometry(const QRect &r)

Переопределяет: QLayout::setGeometry(const QRect &r).

void QBoxLayout::setSpacing(int spacing)

Переопределяет QLayout::setSpacing(). Устанавливает свойство интервала на spacing.

См. также QLayout::setSpacing() и spacing().

void QBoxLayout::setStretch(int index, int stretch)

Устанавливает коэффициент растяжения в позиции index на stretch.

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

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

bool QBoxLayout::setStretchFactor(QWidget *widget, int stretch)

Устанавливает коэффициент растяжения для widget на stretch и возвращает true, если widget найден в этом макете (исключая дочерние макеты); в противном случае возвращает false.

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

bool QBoxLayout::setStretchFactor(QLayout *layout, int stretch)

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

Устанавливает коэффициент растяжения для макета layout на stretch и возвращает true, если layout найден в этом макете (исключая дочерние макеты); в противном случае возвращает false.

[override virtual] QSize QBoxLayout::sizeHint() const

Переопределяет: QLayoutItem::sizeHint() const.

int QBoxLayout::spacing() const

Переопределяет QLayout::spacing(). Если свойство интервала валидно, возвращается это значение. В противном случае вычисляется и возвращается значение для свойства интервала. Поскольку интервал макета в виджете зависит от стиля, если родитель является виджетом, он запрашивает стиль для (горизонтального или вертикального) интервала макета. В противном случае родитель является макетом, и он запрашивает у родительского макета интервал.

См. также QLayout::spacing() и setSpacing().

int QBoxLayout::stretch(int index) const

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

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

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

[override virtual] QLayoutItem *QBoxLayout::takeAt(int index)

Переопределяет: QLayout::takeAt(int index).