Класс QGridLayout

Класс QGridLayout размещает виджеты в сетке. Подробнее...

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

Свойства

• horizontalSpacing : int
• verticalSpacing : int

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

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

Переопределённые защищённые функции

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

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

Столбцы и строки ведут себя идентично; мы будем обсуждать столбцы, но существуют эквивалентные функции для строк.

Каждый столбец имеет минимальную ширину и коэффициент растяжения. Минимальная ширина — это наибольшее из значений, заданных с помощью setColumnMinimumWidth(), и минимальной ширины каждого виджета в этом столбце. Коэффициент растяжения устанавливается с помощью setColumnStretch() и определяет, сколько доступного пространства получит столбец сверх его минимального необходимого значения.

Обычно каждый управляемый виджет или макет помещается в отдельную ячейку с помощью addWidget(). Также возможно, чтобы виджет занимал несколько ячеек, используя перегрузки addItem() и addWidget() с указанием размаха по строкам и столбцам. В этом случае QGridLayout определит, как распределить размер по столбцам/строкам (на основе коэффициентов растяжения).

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

На этом рисунке показан фрагмент диалогового окна с сеткой из пяти столбцов и трёх строк (сетка показана поверх в пурпурном цвете):

Столбцы 0, 2 и 4 в этом фрагменте диалога состоят из QLabel, QLineEdit и QListBox. Столбцы 1 и 3 являются占位符, созданными с помощью setColumnMinimumWidth(). Строка 0 состоит из трех объектов QLabel, строка 1 из трех объектов QLineEdit, а строка 2 из трех объектов QListBox. Мы использовали占位符-столбцы (1 и 3), чтобы обеспечить правильное расстояние между столбцами.

Обратите внимание, что столбцы и строки не имеют одинаковой ширины или высоты. Если вы хотите, чтобы два столбца имели одинаковую ширину, вы должны самостоятельно задать для них одинаковые минимальные ширины и коэффициенты растяжения. Это делается с помощью setColumnMinimumWidth() и setColumnStretch().

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

После добавления макета вы можете начать размещать виджеты и другие макеты в ячейки вашего сетки, используя addWidget(), addItem() и addLayout().

QGridLayout также включает две ширины отступов: отступ содержимого и интервал. Отступ содержимого — это ширина выделенной области вдоль каждой из четырех сторон QGridLayout. Интервал() — это ширина автоматически выделенного интервала между соседними ячейками.

Значения по умолчанию отступа содержимого предоставляются стилем style. Значение по умолчанию, задаваемое стилями Qt, равно 9 для дочерних виджетов и 11 для окон. Интервал по умолчанию равен ширине отступа для макета верхнего уровня или равен ширине отступа родительского макета.

См. также QBoxLayout, QStackedLayout, Управление макетами и Пример основных макетов.

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

QGridLayout::QGridLayout()

Создает новый макет сетки.

Вы должны вставить эту сетку в другой макет. Вы можете вставлять виджеты и макеты в этот макет в любое время, но макет не будет выстроен до того, как этот макет будет вставлен в другой.

QGridLayout::QGridLayout(QWidget *parent)

Создает новый QGridLayout с родительским виджетом parent. Изначально макет имеет одну строку и один столбец и будет расширяться при вставке новых элементов.

[virtual] QGridLayout::~QGridLayout()

Уничтожает макет сетки. Управление геометрией прекращается, если это сетка верхнего уровня.

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

void QGridLayout::addItem(QLayoutItem *item, int row, int column, int rowSpan = 1, int columnSpan = 1, Qt::Alignment alignment = Qt::Alignment())

Добавляет item в позицию row, column, охватывающую rowSpan строк и columnSpan столбцов, и выравнивает его в соответствии с alignment. Если rowSpan и/или columnSpan равно -1, элемент будет расширяться до нижнего и/или правого края соответственно. Макет принимает владение над item.

Предупреждение: Не используйте эту функцию для добавления дочерних макетов или дочерних виджетов. Используйте addLayout() или addWidget() вместо этого.

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

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

void QGridLayout::addLayout(QLayout *layout, int row, int column, Qt::Alignment alignment = Qt::Alignment())

Размещает layout в позиции (row, column) в сетке. Верхний левый угол — это (0, 0).

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

Неравное нулю выравнивание указывает, что макет не должен расширяться, чтобы заполнить доступное пространство, а должен быть размером в соответствии с sizeHint().

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

void QGridLayout::addLayout(QLayout *layout, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

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

Этот вариант добавляет макет layout в сетку ячеек, охватывая несколько строк/столбцов. Ячейка будет начинаться с row, column, охватывая rowSpan строк и columnSpan столбцов.

Если rowSpan и/или columnSpan равно -1, макет будет расширяться до нижнего и/или правого края соответственно.

void QGridLayout::addWidget(QWidget *widget, int row, int column, Qt::Alignment alignment = Qt::Alignment())

Добавляет данный widget в ячейку сетки в позиции row, column. Верхний левый угол по умолчанию (0, 0).

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

void QGridLayout::addWidget(QWidget *widget, int fromRow, int fromColumn, int rowSpan, int columnSpan, Qt::Alignment alignment = Qt::Alignment())

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

Этот вариант добавляет данный widget в сетку ячеек, охватывая несколько строк/столбцов. Ячейка начнется с fromRow, fromColumn, охватывая rowSpan строк и columnSpan столбцов. widget будет иметь указанное alignment.

Если rowSpan и/или columnSpan равно -1, виджет будет расширяться до нижнего и/или правого края соответственно.

QRect QGridLayout::cellRect(int row, int column) const

Возвращает геометрию ячейки со строкой row и столбцом column в сетке. Возвращает недействительный прямоугольник, если row или column находятся за пределами сетки.

Предупреждение: в текущей версии Qt эта функция не возвращает корректные результаты до тех пор, пока не будет вызван setGeometry(), т. е. после того, как parentWidget() становится видимым.

int QGridLayout::columnCount() const

Возвращает количество столбцов в этой сетке.

int QGridLayout::columnMinimumWidth(int column) const

Возвращает интервал столбцов для столбца column.

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

int QGridLayout::columnStretch(int column) const

Возвращает коэффициент растяжения для столбца column.

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

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

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

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

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

void QGridLayout::getItemPosition(int index, int *row, int *column, int *rowSpan, int *columnSpan) const

Возвращает информацию о позиции элемента с заданным index.

Переменные, переданные как row и column, обновляются позицией элемента в макете, а переменные rowSpan и columnSpan обновляются вертикальным и горизонтальным размахом элемента.

См. также itemAtPosition() и itemAt().

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

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

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

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

[override virtual] void QGridLayout::invalidate()

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

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

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

QLayoutItem *QGridLayout::itemAtPosition(int row, int column) const

Возвращает элемент макета, занимающий ячейку (row, column), или nullptr если ячейка пуста.

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

См. также getItemPosition() и indexOf().

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

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

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

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

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

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

Qt::Corner QGridLayout::originCorner() const

Возвращает угол, используемый в качестве начала координат сетки, т.е. для позиции (0, 0).

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

int QGridLayout::rowCount() const

Возвращает количество строк в этой сетке.

int QGridLayout::rowMinimumHeight(int row) const

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

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

int QGridLayout::rowStretch(int row) const

Возвращает коэффициент растяжения для строки row.

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

void QGridLayout::setColumnMinimumWidth(int column, int minSize)

Устанавливает минимальную ширину столбца column в minSize пикселей.

См. также columnMinimumWidth() и setRowMinimumHeight().

void QGridLayout::setColumnStretch(int column, int stretch)

Устанавливает коэффициент растяжения столбца column равным stretch. Первый столбец имеет номер 0.

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

По умолчанию коэффициент растяжения равен 0. Если коэффициент растяжения равен 0 и ни один другой столбец в этой таблице не может расти, столбец все равно может расти.

Альтернативный подход заключается в добавлении отступов с помощью addItem() с QSpacerItem.

См. также columnStretch() и setRowStretch().

[override virtual] void QGridLayout::setGeometry(const QRect &rect)

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

void QGridLayout::setOriginCorner(Qt::Corner corner)

Устанавливает угол начала координат сетки, т.е. позицию (0, 0), на corner.

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

void QGridLayout::setRowMinimumHeight(int row, int minSize)

Устанавливает минимальную высоту строки row в minSize пикселей.

См. также rowMinimumHeight() и setColumnMinimumWidth().

void QGridLayout::setRowStretch(int row, int stretch)

Устанавливает коэффициент растяжения строки row равным stretch. Первая строка имеет номер 0.

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

По умолчанию коэффициент растяжения равен 0. Если коэффициент растяжения равен 0 и ни одна другая строка в этой таблице не может расти, строка все равно может расти.

См. также rowStretch(), setRowMinimumHeight(), и setColumnStretch().

void QGridLayout::setSpacing(int spacing)

Эта функция устанавливает вертикальный и горизонтальный отступы в spacing.

См. также spacing(), setVerticalSpacing(), и setHorizontalSpacing().

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

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

int QGridLayout::spacing() const

Если вертикальный отступ равен горизонтальному отступу, эта функция возвращает это значение; в противном случае возвращает -1.

См. также setSpacing(), verticalSpacing(), и horizontalSpacing().

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

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