Описание класса QGraphicsGridLayout

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

 #include <QGraphicsGridLayout>

Унаследован от: QGraphicsLayout.

Этот класс был введён в Qt 4.4.

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

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

	QGraphicsGridLayout ( QGraphicsLayoutItem * parent = 0 )
virtual	~QGraphicsGridLayout ()
void	addItem ( QGraphicsLayoutItem * item, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = 0 )
void	addItem ( QGraphicsLayoutItem * item, int row, int column, Qt::Alignment alignment = 0 )
Qt::Alignment	alignment ( QGraphicsLayoutItem * item ) const
Qt::Alignment	columnAlignment ( int column ) const
int	columnCount () const
qreal	columnMaximumWidth ( int column ) const
qreal	columnMinimumWidth ( int column ) const
qreal	columnPreferredWidth ( int column ) const
qreal	columnSpacing ( int column ) const
int	columnStretchFactor ( int column ) const
qreal	horizontalSpacing () const
QGraphicsLayoutItem *	itemAt ( int row, int column ) const
void	removeItem ( QGraphicsLayoutItem * item )
Qt::Alignment	rowAlignment ( int row ) const
int	rowCount () const
qreal	rowMaximumHeight ( int row ) const
qreal	rowMinimumHeight ( int row ) const
qreal	rowPreferredHeight ( int row ) const
qreal	rowSpacing ( int row ) const
int	rowStretchFactor ( int row ) const
void	setAlignment ( QGraphicsLayoutItem * item, Qt::Alignment alignment )
void	setColumnAlignment ( int column, Qt::Alignment alignment )
void	setColumnFixedWidth ( int column, qreal width )
void	setColumnMaximumWidth ( int column, qreal width )
void	setColumnMinimumWidth ( int column, qreal width )
void	setColumnPreferredWidth ( int column, qreal width )
void	setColumnSpacing ( int column, qreal spacing )
void	setColumnStretchFactor ( int column, int stretch )
void	setHorizontalSpacing ( qreal spacing )
void	setRowAlignment ( int row, Qt::Alignment alignment )
void	setRowFixedHeight ( int row, qreal height )
void	setRowMaximumHeight ( int row, qreal height )
void	setRowMinimumHeight ( int row, qreal height )
void	setRowPreferredHeight ( int row, qreal height )
void	setRowSpacing ( int row, qreal spacing )
void	setRowStretchFactor ( int row, int stretch )
void	setSpacing ( qreal spacing )
void	setVerticalSpacing ( qreal spacing )
qreal	verticalSpacing () const

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

virtual int	count () const
virtual void	invalidate ()
virtual QGraphicsLayoutItem *	itemAt ( int index ) const
virtual void	removeAt ( int index )
virtual void	setGeometry ( const QRectF & rect )
virtual QSizeF	sizeHint ( Qt::SizeHint which, const QSizeF & constraint = QSizeF() ) const

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

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

2 статических открытых члена, унаследованных от QGraphicsLayout
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 = 0 )

Создаёт объект QGraphicsGridLayout. parent передаётся в конструктор QGraphicsLayout.

QGraphicsGridLayout::~QGraphicsGridLayout () `[virtual]`

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

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

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

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

Добавляет элемент 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().

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

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

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

qreal QGraphicsGridLayout::horizontalSpacing () const

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

Смотрите также setHorizontalSpacing().

void QGraphicsGridLayout::invalidate () `[virtual]`

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

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

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

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

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

Возвращает элемент с индексом index или 0 если элемента с таким индексом нет.

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

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

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

Смотрите также addItem().

void QGraphicsGridLayout::removeItem ( QGraphicsLayoutItem * item )

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

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

Смотрите также 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().

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

Переопределено из 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().

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

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

qreal QGraphicsGridLayout::verticalSpacing () const

Возвращает вертикальный интервал компоновщика по умолчанию.

Смотрите также setVerticalSpacing().

Оглавление