| Home · All Classes · Modules |
The QGroupBox widget provides a group box frame with a title. More...
Inherits QWidget.
The QGroupBox widget provides a group box frame with a title.
A group box provides a frame, a title and a keyboard shortcut, and displays various other widgets inside itself. The title is on top, the keyboard shortcut moves keyboard focus to one of the group box's child widgets.
QGroupBox also lets you set the title (normally set in the constructor) and the title's alignment. Group boxes can be checkable; child widgets in checkable group boxes are enabled or disabled depending on whether or not the group box is checked.
You can minimize the space consumption of a group box by enabling the flat property. In most styles, enabling this property results in the removal of the left, right and bottom edges of the frame.
QGroupBox doesn't automatically lay out the child widgets (which are often QCheckBoxes or QRadioButtons but can be any widgets). The following example shows how we can set up a QGroupBox with a layout:
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);
 |
 |
 |
| A Windows XP style group box. | A Macintosh style group box. | A Plastique style group box. |
The parent argument, if not None, causes self to be owned by Qt instead of PyQt.
Constructs a group box widget with the given parent but with no title.
The parent argument, if not None, causes self to be owned by Qt instead of PyQt.
Constructs a group box with the given title and parent.
Reimplemented from QWidget.changeEvent().
Reimplemented from QObject.childEvent().
Reimplemented from QObject.event().
Reimplemented from QWidget.focusInEvent().
Initialize option with the values from this QGroupBox. This method is useful for subclasses when they need a QStyleOptionGroupBox, but don't want to fill in all the information themselves.
See also QStyleOption.initFrom().
Reimplemented from QWidget.minimumSizeHint().
Reimplemented from QWidget.mouseMoveEvent().
Reimplemented from QWidget.mousePressEvent().
Reimplemented from QWidget.mouseReleaseEvent().
Reimplemented from QWidget.paintEvent().
Reimplemented from QWidget.resizeEvent().
This method is also a Qt slot with the C++ signature void setChecked(bool).
This is the default overload of this signal.
This signal is emitted when the check box is activated (i.e. pressed down then released while the mouse cursor is inside the button), or when the shortcut key is typed, Notably, this signal is not emitted if you call setChecked().
If the check box is checked checked is true; it is false if the check box is unchecked.
This function was introduced in Qt 4.2.
See also checkable, toggled(), and checked.
This is the default overload of this signal.
If the group box is checkable, this signal is emitted when the check box is toggled. on is true if the check box is checked; otherwise it is false.
See also checkable.
| PyQt 4.9.4 for Windows | Copyright © Riverbank Computing Ltd and Nokia 2012 | Qt 4.8.2 |