Главная · Все классы · Все функции · Обзоры

Описание класса QFormLayout
[Модуль QtGui]

Класс QFormLayout управляет формами виджетов ввода и связанных с ними меток. Далее...

 #include <QFormLayout>

Унаследован от QLayout.

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

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

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

Свойства

• 2 свойства, унаследованных от QLayout
• 1 свойство, унаследованное от QObject

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

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

• 35 открытых функций, унаследованных от QLayout
• 29 открытых функций, унаследованных от QObject
• 17 открытых функций, унаследованных от QLayoutItem

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

• 1 открытый слот, унаследованный от QObject
• 1 сигнал, унаследованный от QObject
• 1 статический открытый член, унаследованный от QLayout
• 5 статических открытых членов, унаследованных от QObject
• 4 защищенные функции, унаследованные от QLayout
• 7 защищенных функций, унаследованных от QObject

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

Класс QFormLayout управляет формами виджетов ввода и связанных с ними меток.

QFormLayout является вспомогательным классом компоновки, который размещает свои дочерние элементы в двух столбцах. Левый столбец содержит метки, а правый столбец содержит виджеты-поля ввода (однострочные редакторы, счётчики и т.д.).

Обычно такая форма компоновки в два столбца достигалась с использованием QGridLayout. QFormLayout является высокоуровневой альтернативой, которая предоставляет следующие преимущества:

• Соблюдение руководств по внешнему виду и поведению на различных платформах.

  Например, руководства Mac OS X Aqua и KDE указывают, что метки должны быть выровнены по правому краю, в то время как приложения Windows и GNOME обычно используют выравнивание по левому краю.

• Поддержка переноса длинных строк.

  Для устройств с маленькими экранами QFormLayout может быть настроен на перенос длинных строк или даже на перенос всех строк.

• Вспомогательное API для создания пар метка--поле.

  Перегруженная addRow(), которая принимает QString и QWidget *, самостоятельно создаёт QLabel и автоматически устанавливает её партнёра. Тогда можно написать код, похожий на это:

   QFormLayout *formLayout = new QFormLayout;
   formLayout->addRow(tr("&Name:"), nameLineEdit);
   formLayout->addRow(tr("&Email:"), emailLineEdit);
   formLayout->addRow(tr("&Age:"), ageSpinBox);
   setLayout(formLayout);

  Сравните его со следующим кодом, написанным при помощи QGridLayout:

   nameLabel = new QLabel(tr("&Name:"));
   nameLabel->setBuddy(nameLineEdit);
  
   emailLabel = new QLabel(tr("&Name:"));
   emailLabel->setBuddy(emailLineEdit);
  
   ageLabel = new QLabel(tr("&Name:"));
   ageLabel->setBuddy(ageSpinBox);
  
   QGridLayout *gridLayout = new QGridLayout;
   gridLayout->addWidget(nameLabel, 0, 0);
   gridLayout->addWidget(nameLineEdit, 0, 1);
   gridLayout->addWidget(emailLabel, 1, 0);
   gridLayout->addWidget(emailLineEdit, 1, 1);
   gridLayout->addWidget(ageLabel, 2, 0);
   gridLayout->addWidget(ageSpinBox, 2, 1);
   setLayout(gridLayout);

В таблице ниже показан внешний вид по умолчанию в разных стилях.

Производные стили QCommonStyle (за исключением QPlastiqueStyle)	QMacStyle	QPlastiqueStyle	Стили Qt Extended
Традиционный стиль, используемый для Windows, GNOME и ранних версий KDE. Метки выровнены по левому краю, а расширяющиеся поля увеличиваются, чтобы заполнить доступное место. (Это обычно соответствует тому, что мы получили бы при использовании QGridLayout с двумя столбцами.)	Стиль, основанный на руководстве Mac OS X Aqua. Метки выровнены по правому краю, поля не увеличиваются за пределы их подсказки о размере, а форма центрируется по горизонтали.	Рекомендуемый стиль для приложений KDE. Похоже на MacStyle, за исключением того, что формы выровнены по левому краю, а все поля увеличиваются, чтобы заполнить доступное место.	Стиль по умолчанию для стилей Qt Extended. Метки выровнены по правому краю, расширяющиеся поля увеличиваются, чтобы заполнить доступное место, и включён перенос строк для длинных строк.

Стиль формы может быть также переопределён индивидуально вызовами setLabelAlignment(), setFormAlignment(), setFieldGrowthPolicy() и setRowWrapPolicy(). Например, чтобы на всех платформах сымитировать внешний вид компоновки формы QMacStyle, но с выравниванием меток по левому краю, вы должны написать:

 formLayout->setRowWrapPolicy(QFormLayout::DontWrapRows);
 formLayout->setFieldGrowthPolicy(QFormLayout::FieldsStayAtSizeHint);
 formLayout->setFormAlignment(Qt::AlignHCenter | Qt::AlignTop);
 formLayout->setLabelAlignment(Qt::AlignLeft);

Смотрите также QGridLayout, QBoxLayout и QStackedLayout.

Описание типов-членов

enum QFormLayout::FieldGrowthPolicy

Данное перечисление определяет различные политики, которые могут быть использованы для контроля способов, которыми могут увеличиваться поля формы.

Смотрите также fieldGrowthPolicy.

enum QFormLayout::ItemRole

Данное перечисление определяет типы виджетов (или других элементов компоновщика), которые могут появиться в строке.

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

enum QFormLayout::RowWrapPolicy

Данное перечисление определяет различные политики, которые могут быть использованы управления тем, как могут переноситься строки формы.

Смотрите также rowWrapPolicy.

Описание свойств

fieldGrowthPolicy : FieldGrowthPolicy

Это свойство содержит способы, которыми могут увеличиваться поля формы.

Значение по умолчанию зависит от виджета или стиля приложения. Для QMacStyle значением по умолчанию является FieldsStayAtSizeHint; для производных от QCommonStyle стилей (как Plastique и Windows) - ExpandingFieldsGrow; для стилей Qt Extended - AllNonFixedFieldsGrow.

Если ни одно поле не может быть увеличено, а форма изменяет размер, то дополнительное место распределяется в соответствии с текущим выравниванием формы.

Функции доступа:

Смотрите также formAlignment и rowWrapPolicy.

formAlignment : Qt::Alignment

Это свойство содержит выравнивание содержимого компоновщика формы в геометрии компоновщика.

Значение по умолчанию зависит от виджета или стиля приложения. Для QMacStyle значением по умолчанию является Qt::AlignHCenter | Qt::AlignTop; для других стилей - Qt::AlignLeft | Qt::AlignTop.

Функции доступа:

Смотрите также labelAlignment и rowWrapPolicy.

horizontalSpacing : int

Это свойство содержит расстояние между виджетами, которые расположены бок о бок.

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

Функции доступа:

Смотрите также verticalSpacing, QStyle::pixelMetric() и PM_LayoutHorizontalSpacing.

labelAlignment : Qt::Alignment

Это свойство содержит горизонтальное выравнивание меток.

Значение по умолчанию зависит от виджета или стиля приложения. Для производных от QCommonStyle стилей, исключая QPlastiqueStyle, значением по умолчанию является Qt::AlignLeft; для других стилей - Qt::AlignRight.

Функции доступа:

Смотрите также formAlignment.

rowWrapPolicy : RowWrapPolicy

Это свойство содержит способ, которым переносятся строки формы.

Значение по умолчанию зависит от виджета или стиля приложения. Для стилей Qt Extended и QS60Style значением по умолчанию является WrapLongRows; для других стилей - DontWrapRows.

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

Функции доступа:

Смотрите также fieldGrowthPolicy.

verticalSpacing : int

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

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

Функции доступа:

Смотрите также horizontalSpacing, QStyle::pixelMetric() и PM_LayoutHorizontalSpacing.

Описание функций-членов

QFormLayout::QFormLayout ( QWidget * parent = 0 )

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

Смотрите также QWidget::setLayout().

QFormLayout::~QFormLayout ()

Уничтожает компоновщик формы.

void QFormLayout::addItem ( QLayoutItem * item )   [virtual]

Переопределено из QLayout::addItem().

void QFormLayout::addRow ( QWidget * label, QWidget * field )

Добавляет новую строку в нижнюю часть этого компоновщика формы с заданными меткой label и полем field.

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

void QFormLayout::addRow ( QWidget * label, QLayout * field )

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

void QFormLayout::addRow ( const QString & labelText, QWidget * field )

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

Эта перегруженная функция автоматически скрытно создаёт QLabel с labelText в качестве его текста. Поле field устанавливается для QLabel как новый партнёр.

void QFormLayout::addRow ( const QString & labelText, QLayout * field )

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

Эта перегруженная функция автоматически скрытно создаёт QLabel с labelText в качестве его текста.

void QFormLayout::addRow ( QWidget * widget )

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

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

void QFormLayout::addRow ( QLayout * layout )

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

Добавляет указанный компоновщик layout в конец этого компоновщика формы. Компоновщик layout занимает оба столбца.

int QFormLayout::count () const   [virtual]

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

Qt::Orientations QFormLayout::expandingDirections () const   [virtual]

Переопределено из QLayoutItem::expandingDirections().

void QFormLayout::getItemPosition ( int index, int * rowPtr, ItemRole * rolePtr ) const

Возвращает строку и роль (столбец) элемента с указанным индексом index. Если index находится вне границ, то *rowPtr устанавливается в -1; в противном случае строка сохраняется в *rowPtr, а роль - в *rolePtr.

Смотрите также itemAt(), count(), getLayoutPosition() и getWidgetPosition().

void QFormLayout::getLayoutPosition ( QLayout * layout, int * rowPtr, ItemRole * rolePtr ) const

Возвращает строку и роль (столбец) указанного дочернего компоновщика layout. Если компоновщик layout не находится на компоновщике формы, то *rowPtr устанавливается в -1; в противном случае строка сохраняется в *rowPtr, а роль - в *rolePtr.

void QFormLayout::getWidgetPosition ( QWidget * widget, int * rowPtr, ItemRole * rolePtr ) const

Возвращает строку и роль (столбец) указанного виджета widget в компоновщике. Если виджет widget не находится в компоновщике, то *rowPtr устанавливается в -1; в противном случае строка сохраняется в *rowPtr, а роль - в *rolePtr.

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

bool QFormLayout::hasHeightForWidth () const   [virtual]

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

int QFormLayout::heightForWidth ( int width ) const   [virtual]

Переопределено от QLayoutItem::heightForWidth().

void QFormLayout::insertRow ( int row, QWidget * label, QWidget * field )

Inserts a new row at position row in this form layout, with the given label and field. If row is out of bounds, the new row is added at the end.

See also addRow().

void QFormLayout::insertRow ( int row, QWidget * label, QLayout * field )

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

void QFormLayout::insertRow ( int row, const QString & labelText, QWidget * field )

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

Эта перегруженная функция автоматически скрытно создаёт QLabel с labelText в качестве его текста. Поле field устанавливается для QLabel как новый партнёр.

void QFormLayout::insertRow ( int row, const QString & labelText, QLayout * field )

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

Эта перегруженная функция автоматически скрытно создаёт QLabel с labelText в качестве его текста.

void QFormLayout::insertRow ( int row, QWidget * widget )

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

Inserts the specified widget at position row in this form layout. The widget spans both columns. If row is out of bounds, the widget is added at the end.

void QFormLayout::insertRow ( int row, QLayout * layout )

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

Inserts the specified layout at position row in this form layout. The layout spans both columns. If row is out of bounds, the widget is added at the end.

void QFormLayout::invalidate ()   [virtual]

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

QLayoutItem * QFormLayout::itemAt ( int row, ItemRole role ) const

Returns the layout item in the given row with the specified role (column). Returns 0 if there is no such item.

See also QLayout::itemAt() and setItem().

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

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

QWidget * QFormLayout::labelForField ( QWidget * field ) const

Returns the label associated with the given field.

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

QWidget * QFormLayout::labelForField ( QLayout * field ) const

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

QSize QFormLayout::minimumSize () const   [virtual]

Переопределено из QLayoutItem::minimumSize().

int QFormLayout::rowCount () const

Returns the number of rows in the form.

See also QLayout::count().

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

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

void QFormLayout::setItem ( int row, ItemRole role, QLayoutItem * item )

Sets the item in the given row for the given role to item, extending the layout with empty rows if necessary.

If the cell is already occupied, the item is not inserted and an error message is sent to the console. The item spans both columns.

Warning: Do not use this function to add child layouts or child widget items. Use setLayout() or setWidget() instead.

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

void QFormLayout::setLayout ( int row, ItemRole role, QLayout * layout )

Sets the sub-layout in the given row for the given role to layout, extending the form layout with empty rows if necessary.

If the cell is already occupied, the layout is not inserted and an error message is sent to the console.

Note: For most applications, addRow() or insertRow() should be used instead of setLayout().

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

void QFormLayout::setSpacing ( int spacing )

This function sets both the vertical and horizontal spacing to spacing.

See also spacing(), setVerticalSpacing(), and setHorizontalSpacing().

void QFormLayout::setWidget ( int row, ItemRole role, QWidget * widget )

Sets the widget in the given row for the given role to widget, extending the layout with empty rows if necessary.

If the cell is already occupied, the widget is not inserted and an error message is sent to the console.

Note: For most applications, addRow() or insertRow() should be used instead of setWidget().

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

QSize QFormLayout::sizeHint () const   [virtual]

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

int QFormLayout::spacing () const

If the vertical spacing is equal to the horizontal spacing, this function returns that value; otherwise it returns -1.

See also setSpacing(), verticalSpacing(), and horizontalSpacing().

QLayoutItem * QFormLayout::takeAt ( int index )   [virtual]

Переопределено из QLayout::takeAt().