Класс QGroupBox

Виджет QGroupBox предоставляет рамку группы с заголовком. Подробнее...

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

Свойства

• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

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

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

• 214 открытых функций унаследовано от QWidget
• 34 открытых функций унаследовано от QObject
• 14 открытых функций унаследовано от QPaintDevice

Открытые слоты

• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject

Сигналы

• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Защищённые функции

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

• 35 защищённых функций унаследовано от QWidget
• 9 защищённых функций унаследовано от QObject
• 1 защищённая функция унаследовано от QPaintDevice

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

• 1 общедоступная переменная унаследована от QObject
• 5 статических общедоступных членов унаследовано от QWidget
• 10 статических общедоступных членов унаследовано от QObject
• 1 защищённый слот унаследовано от QWidget
• 2 защищённых переменных унаследовано от QObject
• 1 защищённый тип унаследовано от QPaintDevice

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

Виджет QGroupBox предоставляет рамку группы с заголовком.

Группа предоставляет рамку, заголовок вверху, сочетание клавиш и отображает различные другие виджеты внутри себя. Сочетание клавиш переводит фокус клавиатуры на один из дочерних виджетов группы.

QGroupBox также позволяет задать заголовок (обычно устанавливается в конструкторе) и выравнивание заголовка. Группы могут быть отмеченными. Дочерние виджеты в группах с возможностью выбора включены или отключены в зависимости от того, выбран ли виджет группы или нет.

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

QGroupBox не автоматически выравнивает дочерние виджеты (которые часто являются QCheckBox или QRadioButton, но могут быть любыми виджетами). Следующий пример показывает, как мы можем настроить QGroupBox с макетом:

    QGroupBox *groupBox = new QGroupBox(tr("Exclusive Radio Buttons"));

    QRadioButton *radio1 = new QRadioButton(tr("&Radio button 1"));
    QRadioButton *radio2 = new QRadioButton(tr("R&adio button 2"));
    QRadioButton *radio3 = new QRadioButton(tr("Ra&dio button 3"));

    radio1->setChecked(true);

    QVBoxLayout *vbox = new QVBoxLayout;
    vbox->addWidget(radio1);
    vbox->addWidget(radio2);
    vbox->addWidget(radio3);
    vbox->addStretch(1);
    groupBox->setLayout(vbox);

См. также QButtonGroup и Пример группы.

g->setTitle("&User information");

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

QGroupBox::QGroupBox(QWidget *parent = nullptr)

Создает виджет группового поля с заданным parent, но без заголовка.

QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)

Создает групповое поле с заданным title и parent.

[virtual] QGroupBox::~QGroupBox()

Удаляет групповое поле.

[override virtual protected] void QGroupBox::changeEvent(QEvent *ev)

Переопределено из QWidget::changeEvent().

[override virtual protected] void QGroupBox::childEvent(QChildEvent *c)

Переопределено из QObject::childEvent().

[signal] void QGroupBox::clicked(bool checked = false)

Этот сигнал генерируется при активации флажка (т.е., нажатии и отпускании мыши, при этом курсор находится внутри кнопки) или при нажатии сочетания клавиш. Отметим, что этот сигнал не генерируется, если вы вызываете setChecked().

Если флажок установлен, checked имеет значение true; в противном случае, оно равно false.

Функция была введена в Qt 4.2.

См. также checkable, toggled() и checked.

[override virtual protected] bool QGroupBox::event(QEvent *e)

Переопределено из QWidget::event().

[override virtual protected] void QGroupBox::focusInEvent(QFocusEvent *fe)

Переопределено из QWidget::focusInEvent().

[protected] void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const

Инициализирует option значениями из этого QGroupBox. Этот метод полезен для подклассов, когда им нужен QStyleOptionGroupBox, но они не хотят сами заполнять всю информацию.

См. также QStyleOption::initFrom().

[override virtual] QSize QGroupBox::minimumSizeHint() const

Переопределено из QWidget::minimumSizeHint().

[override virtual protected] void QGroupBox::mouseMoveEvent(QMouseEvent *event)

Переопределено из QWidget::mouseMoveEvent().

[override virtual protected] void QGroupBox::mousePressEvent(QMouseEvent *event)

Переопределено из QWidget::mousePressEvent().

[override virtual protected] void QGroupBox::mouseReleaseEvent(QMouseEvent *event)

Переопределено из QWidget::mouseReleaseEvent().

[override virtual protected] void QGroupBox::paintEvent(QPaintEvent *event)

Переопределено из QWidget::paintEvent().

[override virtual protected] void QGroupBox::resizeEvent(QResizeEvent *e)

Переопределено из QWidget::resizeEvent().

[signal] void QGroupBox::toggled(bool on)

Если у группового поля есть флажок, этот сигнал генерируется при переключении флажка. on имеет значение true, если флажок установлен; в противном случае, он имеет значение false.

Примечание: Сигнал-уведомление для свойства checked.

См. также checkable.