Класс QGraphicsGridLayout

Класс QGraphicsGridLayout предоставляет табличную компоновку для управления виджетами в представлении графики. Подробнее...

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

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

Реализованные общедоступные функции

• 10 общедоступных функций, унаследованных от QGraphicsLayout
• 35 общедоступных функций, унаследованных от QGraphicsLayoutItem

Дополнительные унаследованные члены

• 1 защищённый метод, унаследованный от QGraphicsLayout
• 3 защищённых метода, унаследованных от QGraphicsLayoutItem

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

Класс QGraphicsGridLayout предоставляет сеткообразную компоновку для управления виджетами в представлении графики.

Наиболее распространённый способ использования QGraphicsGridLayout — создание объекта в куче без родителя, добавление виджетов и компоновок с помощью вызова addItem() и, наконец, назначение компоновки виджету с помощью вызова QGraphicsWidget::setLayout(). QGraphicsGridLayout автоматически вычисляет размеры сетки по мере добавления элементов.

QGraphicsScene scene;
QGraphicsWidget *textEdit = scene.addWidget(new QTextEdit);
QGraphicsWidget *pushButton = scene.addWidget(new QPushButton);

QGraphicsGridLayout *layout = new QGraphicsGridLayout;
layout->addItem(textEdit, 0, 0);
layout->addItem(pushButton, 0, 1);

QGraphicsWidget *form = new QGraphicsWidget;
form->setLayout(layout);
scene.addItem(form);

Компоновка получает элементы в собственность. В некоторых случаях, когда элемент компоновки также наследуется от QGraphicsItem (например, QGraphicsWidget), возникнет неоднозначность с собственностью, так как элемент компоновки принадлежит двум иерархиям владения. Обратитесь к документации QGraphicsLayoutItem::setOwnedByLayout() для обработки этого случая. Вы можете получить доступ к каждому элементу в компоновке, вызвав count() и itemAt(). Вызов removeAt() удалит элемент из компоновки без его уничтожения.

Рекомендации по размерам и политики размеров в QGraphicsGridLayout

QGraphicsGridLayout учитывает рекомендации по размерам и политики размеров каждого элемента, и когда ячейка в сетке имеет больше места, чем элементы могут заполнить, каждый элемент располагается в соответствии с выравниванием компоновки для этого элемента. Вы можете установить выравнивание для каждого элемента, вызвав setAlignment(), и проверить выравнивание любого элемента, вызвав alignment(). Вы также можете установить выравнивание для всей строки или столбца, вызвав соответственно setRowAlignment() и setColumnAlignment(). По умолчанию элементы выравниваются по верхнему левому углу.

См. также QGraphicsLinearLayout и QGraphicsWidget.

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

QGraphicsGridLayout::QGraphicsGridLayout(QGraphicsLayoutItem *parent = nullptr)

Создаёт экземпляр QGraphicsGridLayout. parent передаётся конструктору QGraphicsLayout.

[virtual] QGraphicsGridLayout::~QGraphicsGridLayout()

Уничтожает объект QGraphicsGridLayout.

void QGraphicsGridLayout::addItem(QGraphicsLayoutItem *item, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = ...)

Добавляет item в сетку по строке row и столбцу column. Можно указать rowSpan, columnSpan и необязательное alignment.

void QGraphicsGridLayout::addItem(QGraphicsLayoutItem *item, int row, int column, Qt::Alignment alignment = ...)

Добавляет item в сетку по строке row и столбцу column. Можно указать необязательное alignment для item.

Qt::Alignment QGraphicsGridLayout::alignment(QGraphicsLayoutItem *item) const

Возвращает выравнивание для item.

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

Qt::Alignment QGraphicsGridLayout::columnAlignment(int column) const

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

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

int QGraphicsGridLayout::columnCount() const

Возвращает количество столбцов в сетке компоновки. Это всегда на единицу больше индекса последнего столбца, занятого элементом компоновки (пустые столбцы учитываются, кроме тех, которые находятся в конце).

qreal QGraphicsGridLayout::columnMaximumWidth(int column) const

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

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

qreal QGraphicsGridLayout::columnMinimumWidth(int column) const

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

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

qreal QGraphicsGridLayout::columnPreferredWidth(int column) const

Возвращает предпочтительную ширину для column.

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

qreal QGraphicsGridLayout::columnSpacing(int column) const

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

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

int QGraphicsGridLayout::columnStretchFactor(int column) const

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

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

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

Переопределено из QGraphicsLayout::count().

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

qreal QGraphicsGridLayout::horizontalSpacing() const

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

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

[override virtual] void QGraphicsGridLayout::invalidate()

Переопределено из QGraphicsLayout::invalidate().

QGraphicsLayoutItem *QGraphicsGridLayout::itemAt(int row, int column) const

Возвращает указатель на элемент компоновки в позиции (row, column).

[override virtual] QGraphicsLayoutItem *QGraphicsGridLayout::itemAt(int index) const

Переопределено из QGraphicsLayout::itemAt().

Возвращает элемент компоновки в позиции index или 0, если в этой позиции нет элемента компоновки.

[override virtual] void QGraphicsGridLayout::removeAt(int index)

Переопределено из QGraphicsLayout::removeAt().

Удаляет элемент компоновки в позиции index без его уничтожения. Владение элементом передаётся вызывающей стороне.

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

void QGraphicsGridLayout::removeItem(QGraphicsLayoutItem *item)

Удаляет элемент компоновки item без его уничтожения. Владение элементом передаётся вызывающей стороне.

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

Qt::Alignment QGraphicsGridLayout::rowAlignment(int row) const

Возвращает выравнивание для row.

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

int QGraphicsGridLayout::rowCount() const

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

qreal QGraphicsGridLayout::rowMaximumHeight(int row) const

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

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

qreal QGraphicsGridLayout::rowMinimumHeight(int row) const

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

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

qreal QGraphicsGridLayout::rowPreferredHeight(int row) const

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

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

qreal QGraphicsGridLayout::rowSpacing(int row) const

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

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

int QGraphicsGridLayout::rowStretchFactor(int row) const

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

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

void QGraphicsGridLayout::setAlignment(QGraphicsLayoutItem *item, Qt::Alignment alignment)

Устанавливает выравнивание для item на alignment.

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

void QGraphicsGridLayout::setColumnAlignment(int column, Qt::Alignment alignment)

Устанавливает выравнивание для column на alignment.

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

void QGraphicsGridLayout::setColumnFixedWidth(int column, qreal width)

Устанавливает фиксированную ширину column на width.

void QGraphicsGridLayout::setColumnMaximumWidth(int column, qreal width)

Устанавливает максимальную ширину column на width.

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

void QGraphicsGridLayout::setColumnMinimumWidth(int column, qreal width)

Устанавливает минимальную ширину для column на width.

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

void QGraphicsGridLayout::setColumnPreferredWidth(int column, qreal width)

Устанавливает предпочтительную ширину для column на width.

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

void QGraphicsGridLayout::setColumnSpacing(int column, qreal spacing)

Устанавливает интервал для column на spacing.

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

void QGraphicsGridLayout::setColumnStretchFactor(int column, int stretch)

Устанавливает коэффициент растяжения для column на stretch.

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

[override virtual] void QGraphicsGridLayout::setGeometry(const QRectF &rect)

Переопределено из QGraphicsLayoutItem::setGeometry().

Устанавливает ограничивающую геометрию сетки на rect.

void QGraphicsGridLayout::setHorizontalSpacing(qreal spacing)

Устанавливает стандартный горизонтальный интервал для сетки на spacing.

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

void QGraphicsGridLayout::setRowAlignment(int row, Qt::Alignment alignment)

Устанавливает выравнивание row на alignment.

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

void QGraphicsGridLayout::setRowFixedHeight(int row, qreal height)

Устанавливает фиксированную высоту для строки, row, на height.

void QGraphicsGridLayout::setRowMaximumHeight(int row, qreal height)

Устанавливает максимальную высоту для строки, row, на height.

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

void QGraphicsGridLayout::setRowMinimumHeight(int row, qreal height)

Устанавливает минимальную высоту для строки, row, на height.

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

void QGraphicsGridLayout::setRowPreferredHeight(int row, qreal height)

Устанавливает предпочтительную высоту для строки, row, на height.

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

void QGraphicsGridLayout::setRowSpacing(int row, qreal spacing)

Устанавливает интервал для row на spacing.

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

void QGraphicsGridLayout::setRowStretchFactor(int row, int stretch)

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

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

void QGraphicsGridLayout::setSpacing(qreal spacing)

Устанавливает стандартный интервал сетки, как вертикальный, так и горизонтальный, на spacing.

См. также rowSpacing() и columnSpacing().

void QGraphicsGridLayout::setVerticalSpacing(qreal spacing)

Устанавливает стандартный вертикальный интервал для сетки на spacing.

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

[override virtual] QSizeF QGraphicsGridLayout::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

Переопределено из QGraphicsLayoutItem::sizeHint().

qreal QGraphicsGridLayout::verticalSpacing() const

Возвращает стандартный вертикальный интервал для сетки.

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