Описание класса QFormLayoutКласс QFormLayout управляет формами виджетов ввода и связанных с ними меток. Далее... #include <QFormLayout> Унаследован от: QLayout. Этот класс был введён в Qt 4.4. Открытые типы
Свойства
Открытые функции
Переопределённые открытые функции
Дополнительные унаследованные члены
Подробное описаниеКласс QFormLayout управляет формами виджетов ввода и связанных с ними меток. QFormLayout является вспомогательным классом компоновки, который размещает свои дочерние элементы в двух столбцах. Левый столбец содержит метки, а правый столбец содержит виджеты-поля ввода (однострочные редакторы, счётчики и т.д.). Обычно такая форма компоновки в два столбца достигалась с использованием QGridLayout. QFormLayout является высокоуровневой альтернативой, которая предоставляет следующие преимущества:
В таблице ниже показан внешний вид по умолчанию в разных стилях.
Стиль формы может быть также переопределён индивидуально вызовами setLabelAlignment(), setFormAlignment(), setFieldGrowthPolicy() и setRowWrapPolicy(). Например, чтобы на всех платформах сымитировать внешний вид компоновки формы QMacStyle, но с выравниванием меток по левому краю, вы должны написать: formLayout->setRowWrapPolicy(QFormLayout::DontWrapRows); formLayout->setFieldGrowthPolicy(QFormLayout::FieldsStayAtSizeHint); formLayout->setFormAlignment(Qt::AlignHCenter | Qt::AlignTop); formLayout->setLabelAlignment(Qt::AlignLeft); See also QGridLayout, QBoxLayout, and QStackedLayout. Описание типов-членовenum QFormLayout::FieldGrowthPolicyДанное перечисление определяет различные политики, которые могут быть использованы для контроля способов, которыми могут увеличиваться поля формы.
See also fieldGrowthPolicy. enum QFormLayout::ItemRoleДанное перечисление определяет типы виджетов (или других элементов компоновщика), которые могут появиться в строке.
See also itemAt() and getItemPosition(). enum QFormLayout::RowWrapPolicyДанное перечисление определяет различные политики, которые могут быть использованы управления тем, как могут переноситься строки формы.
See also rowWrapPolicy. Описание свойствfieldGrowthPolicy : FieldGrowthPolicyЭто свойство содержит способы, которыми могут увеличиваться поля формы. Значение по умолчанию зависит от виджета или стиля приложения. Для QMacStyle значением по умолчанию является FieldsStayAtSizeHint; для производных от QCommonStyle стилей (как Plastique и Windows) - ExpandingFieldsGrow; для стилей Qt Extended - AllNonFixedFieldsGrow. Если ни одно поле не может быть увеличено, а форма изменяет размер, то дополнительное место распределяется в соответствии с текущим выравниванием формы. Функции доступа:
See also formAlignment and rowWrapPolicy. formAlignment : Qt::AlignmentЭто свойство содержит выравнивание содержимого компоновщика формы в геометрии компоновщика. Значение по умолчанию зависит от виджета или стиля приложения. Для QMacStyle значением по умолчанию является Qt::AlignHCenter | Qt::AlignTop; для других стилей - Qt::AlignLeft | Qt::AlignTop. Функции доступа:
See also labelAlignment and rowWrapPolicy. horizontalSpacing : intЭто свойство содержит расстояние между виджетами, которые расположены бок о бок. По умолчанию, если никакое значение не установлено явно, то горизонтальное расстояние компоновщика наследуется от родительского компоновщика или из настроек стиля для родительского виджета. Функции доступа:
See also verticalSpacing, QStyle::pixelMetric(), and PM_LayoutHorizontalSpacing. labelAlignment : Qt::AlignmentЭто свойство содержит горизонтальное выравнивание меток. Значение по умолчанию зависит от виджета или стиля приложения. Для производных от QCommonStyle стилей, исключая QPlastiqueStyle, значением по умолчанию является Qt::AlignLeft; для других стилей - Qt::AlignRight. Функции доступа:
See also formAlignment. rowWrapPolicy : RowWrapPolicyЭто свойство содержит способ, которым переносятся строки формы. Значение по умолчанию зависит от виджета или стиля приложения. Для стилей Qt Extended и QS60Style значением по умолчанию является WrapLongRows; для других стилей - DontWrapRows. Если вы хотите отобразить каждую метку над связанным с ней полем (вместо отображения рядом с ней), то установите это свойство в WrapAllRows. Функции доступа:
See also fieldGrowthPolicy. verticalSpacing : intЭто свойство содержит расстояние между виджетами, которые расположены вертикально. По умолчанию, если никакое значение не установлено явно, то вертикальное расстояние компоновщика наследуется от родительского компоновщика или из настроек стиля для родительского виджета. Функции доступа:
See also horizontalSpacing, QStyle::pixelMetric(), and 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. See also 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. See also itemAt(), count(), getLayoutPosition(), and 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. See also getItemPosition() and 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 ) constReturns 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 ) constReturns the label associated with the given field. Смотрите также itemAt(). QWidget * QFormLayout::labelForField ( QLayout * field ) constЭто перегруженная функция. QSize QFormLayout::minimumSize () const [virtual]Переопределено из QLayoutItem::minimumSize(). int QFormLayout::rowCount () constReturns 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. See also 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(). See also setLayout(). QSize QFormLayout::sizeHint () const [virtual]Переопределено из QLayoutItem::sizeHint(). int QFormLayout::spacing () constIf 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(). |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |