Класс QGroupBox

Виджет 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(const QString &title, QWidget *parent = nullptr)

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

QGroupBox::QGroupBox(QWidget *parent = nullptr)

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

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

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

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

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

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

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

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

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

См. также checkable.

[virtual] QGroupBox::~QGroupBox()

Уничтожает группу.

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

Переопределяет: QWidget::changeEvent(QEvent *event).

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

Переопределяет: QObject::childEvent(QChildEvent *event).

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

Переопределяет: QWidget::event(QEvent *event).

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

Переопределяет: QWidget::focusInEvent(QFocusEvent *event).

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

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

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

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

Переопределяет: QWidget::minimumSizeHint() const.

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

Переопределяет: QWidget::mouseMoveEvent(QMouseEvent *event).

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

Переопределяет: QWidget::mousePressEvent(QMouseEvent *event).

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

Переопределяет: QWidget::mouseReleaseEvent(QMouseEvent *event).

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

Переопределяет: QWidget::paintEvent(QPaintEvent *event).

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

Переопределяет: QWidget::resizeEvent(QResizeEvent *event).