QGroupBox 小部件提供带有标题的组框框架。 更多...
头: | #include <QGroupBox> |
qmake: | QT += widgets |
继承: | QWidget |
QGroupBox (QWidget * parent = Q_NULLPTR) | |
QGroupBox (const QString & title , QWidget * parent = Q_NULLPTR) | |
~QGroupBox () | |
Qt::Alignment | alignment () const |
bool | isCheckable () const |
bool | isChecked () const |
bool | isFlat () const |
void | setAlignment (int alignment ) |
void | setCheckable (bool checkable ) |
void | setFlat (bool flat ) |
void | setTitle (const QString & title ) |
QString | title () const |
virtual QSize | minimumSizeHint () const |
void | setChecked (bool checked ) |
void | clicked (bool checked = false) |
void | toggled (bool on ) |
void | initStyleOption (QStyleOptionGroupBox * option ) const |
virtual void | changeEvent (QEvent * ev ) |
virtual void | childEvent (QChildEvent * c ) |
virtual bool | event (QEvent * e ) |
virtual void | focusInEvent (QFocusEvent * fe ) |
virtual void | mouseMoveEvent (QMouseEvent * event ) |
virtual void | mousePressEvent (QMouseEvent * event ) |
virtual void | mouseReleaseEvent (QMouseEvent * event ) |
virtual void | paintEvent (QPaintEvent * event ) |
virtual void | resizeEvent (QResizeEvent * e ) |
QGroupBox 小部件提供带有标题的组框框架。
A group box provides a frame, a title on top, a keyboard shortcut, and displays various other widgets inside itself. 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 QCheckBox es or QRadioButton s 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);
另请参阅 QButtonGroup and 组框范例 .
This property holds the alignment of the group box title.
Most styles place the title at the top of the frame. The horizontal alignment of the title can be specified using single values from the following list:
The default alignment is Qt::AlignLeft .
访问函数:
Qt::Alignment | alignment () const |
void | setAlignment (int alignment ) |
另请参阅 Qt::Alignment .
This property holds whether the group box has a checkbox in its title
若此特性为
true
, the group box displays its title using a checkbox in place of an ordinary label. If the checkbox is checked, the group box's children are enabled; otherwise, they are disabled and inaccessible.
By default, group boxes are not checkable.
If this property is enabled for a group box, it will also be initially checked to ensure that its contents are enabled.
访问函数:
bool | isCheckable () const |
void | setCheckable (bool checkable ) |
另请参阅 checked .
This property holds whether the group box is checked
If the group box is checkable, it is displayed with a check box. If the check box is checked, the group box's children are enabled; otherwise, the children are disabled and are inaccessible to the user.
By default, checkable group boxes are also checked.
访问函数:
bool | isChecked () const |
void | setChecked (bool checked ) |
通知程序信号:
void | toggled (bool on ) |
另请参阅 checkable .
This property holds whether the group box is painted flat or has a frame
A group box usually consists of a surrounding frame with a title at the top. If this property is enabled, only the top part of the frame is drawn in most styles; otherwise, the whole frame is drawn.
By default, this property is disabled, i.e., group boxes are not flat unless explicitly specified.
注意: In some styles, flat and non-flat group boxes have similar representations and may not be as distinguishable as they are in other styles.
访问函数:
bool | isFlat () const |
void | setFlat (bool flat ) |
另请参阅 title .
This property holds the group box title text
The group box title text will have a keyboard shortcut if the title contains an ampersand ('&') followed by a letter.
g->setTitle("&User information");
In the example above, Alt+U moves the keyboard focus to the group box. See the QShortcut 文档编制了解细节 (要显示实际和号,使用 &&)。
There is no default title text.
访问函数:
QString | title () const |
void | setTitle (const QString & title ) |
另请参阅 alignment .
Constructs a group box widget with the given parent but with no title.
Constructs a group box with the given title and parent .
Destroys the group box.
[virtual protected]
void
QGroupBox::
changeEvent
(
QEvent
*
ev
)
重实现自 QWidget::changeEvent ().
[virtual protected]
void
QGroupBox::
childEvent
(
QChildEvent
*
c
)
重实现自 QObject::childEvent ().
[signal]
void
QGroupBox::
clicked
(
bool
checked
= false)
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 被发射若调用 setChecked ().
If the check box is checked, checked is true; it is false if the check box is unchecked.
该函数在 Qt 4.2 引入。
另请参阅 checkable , toggled (),和 checked .
[virtual protected]
bool
QGroupBox::
event
(
QEvent
*
e
)
重实现自 QObject::event ().
[virtual protected]
void
QGroupBox::
focusInEvent
(
QFocusEvent
*
fe
)
重实现自 QWidget::focusInEvent ().
[protected]
void
QGroupBox::
initStyleOption
(
QStyleOptionGroupBox
*
option
) const
初始化 option 采用值来自此 QGroupBox 。此方法对子类是有用的,当需要 QStyleOptionGroupBox ,但不希望自己填充所有信息。
另请参阅 QStyleOption::initFrom ().
[virtual]
QSize
QGroupBox::
minimumSizeHint
() const
重实现自 QWidget::minimumSizeHint ().
[virtual protected]
void
QGroupBox::
mouseMoveEvent
(
QMouseEvent
*
event
)
重实现自 QWidget::mouseMoveEvent ().
[virtual protected]
void
QGroupBox::
mousePressEvent
(
QMouseEvent
*
event
)
重实现自 QWidget::mousePressEvent ().
[virtual protected]
void
QGroupBox::
mouseReleaseEvent
(
QMouseEvent
*
event
)
重实现自 QWidget::mouseReleaseEvent ().
[virtual protected]
void
QGroupBox::
paintEvent
(
QPaintEvent
*
event
)
重实现自 QWidget::paintEvent ().
[virtual protected]
void
QGroupBox::
resizeEvent
(
QResizeEvent
*
e
)
重实现自 QWidget::resizeEvent ().
[signal]
void
QGroupBox::
toggled
(
bool
on
)
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.
注意: 通知程序信号对于特性 checked .
另请参阅 checkable .