# QGroupBox Class Reference ## [[QtGui](index.htm) module] 該QGroupBox小部件提供一個帶標題的分組框框架。[More...](#details) 繼承[QWidget](qwidget.html)。 ### Methods * `__init__ (self, QWidget?parent?=?None)` * `__init__ (self, QString?title, QWidget?parent?=?None)` * `Qt.Alignment alignment (self)` * `changeEvent (self, QEvent)` * `childEvent (self, QChildEvent)` * `bool event (self, QEvent)` * `focusInEvent (self, QFocusEvent)` * `initStyleOption (self, QStyleOptionGroupBox?option)` * `bool isCheckable (self)` * `bool isChecked (self)` * `bool isFlat (self)` * `QSize minimumSizeHint (self)` * `mouseMoveEvent (self, QMouseEvent?event)` * `mousePressEvent (self, QMouseEvent?event)` * `mouseReleaseEvent (self, QMouseEvent?event)` * `paintEvent (self, QPaintEvent)` * `resizeEvent (self, QResizeEvent)` * `setAlignment (self, int)` * `setCheckable (self, bool?b)` * `setChecked (self, bool?b)` * `setFlat (self, bool?b)` * `setTitle (self, QString)` * `QString title (self)` ### Qt Signals * `void clicked (bool = 0)` * `void toggled (bool)` * * * ## Detailed Description 該QGroupBox小部件提供一個帶標題的分組框框架。 一組框提供了一個框架，一個標題和一個鍵盤快捷鍵，并顯示其自身內部的各種其他部件。標題是在頂部，鍵盤快捷鍵將鍵盤焦點移至該組框的子控件之一。 QGroupBox也可以讓你設置[title](qgroupbox.html#title-prop)（通常是在構造函數中設置）和標題的[alignment](qgroupbox.html#alignment-prop)。組框可以[checkable](qgroupbox.html#checkable-prop)，在可復組框子控件可以啟用或禁用依賴于組框是否[checked](qgroupbox.html#checked-prop)。 您可以通過啟用最小化組框的空間消耗的[flat](qgroupbox.html#flat-prop)屬性。在大多數[styles](qstyle.html)，從而使該屬性的結果中去除左側，框架的右邊緣和下邊緣的。 QGroupBox不會自動布局的子控件（通常是[QCheckBox](qcheckbox.html)ES或[QRadioButton](qradiobutton.html)s，但可以是任何小部件） 。下面的例子展示了如何建立一個QGroupBox與布局： ``` QGroupBox *groupBox = new QGroupBox(tr("Exclusive Radio Buttons")); [QRadioButton](qradiobutton.html) *radio1 = new [QRadioButton](qradiobutton.html)(tr("&Radio button 1")); [QRadioButton](qradiobutton.html) *radio2 = new [QRadioButton](qradiobutton.html)(tr("R&adio button 2")); [QRadioButton](qradiobutton.html) *radio3 = new [QRadioButton](qradiobutton.html)(tr("Ra&dio button 3")); radio1->setChecked(true); [QVBoxLayout](qvboxlayout.html) *vbox = new [QVBoxLayout](qvboxlayout.html); vbox->addWidget(radio1); vbox->addWidget(radio2); vbox->addWidget(radio3); vbox->addStretch(1); groupBox->setLayout(vbox); ``` |  |  |  | | A [Windows XP style](index.htm) group box. | A [Macintosh style](index.htm) group box. | A [Plastique style](index.htm) group box. | * * * ## Method Documentation ``` QGroupBox.__init__ (self, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個組合框控件與給定_parent_但沒有標題。 ``` QGroupBox.__init__ (self, QString?title, QWidget?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個組合框與給定_title_和_parent_。 ``` Qt.Alignment QGroupBox.alignment (self) ``` [ ``` QGroupBox.changeEvent (self, QEvent) ``` ](index.htm) [從重新實現](index.htm)[QWidget.changeEvent](qwidget.html#changeEvent)（ ） 。 ``` QGroupBox.childEvent (self, QChildEvent) ``` 從重新實現[QObject.childEvent](qobject.html#childEvent)（ ） 。 ``` bool QGroupBox.event (self, QEvent) ``` 從重新實現[QObject.event](qobject.html#event)（ ） 。 ``` QGroupBox.focusInEvent (self, QFocusEvent) ``` 從重新實現[QWidget.focusInEvent](qwidget.html#focusInEvent)（ ） 。 ``` QGroupBox.initStyleOption (self, QStyleOptionGroupBox?option) ``` 初始化_option_與其它的值[QGroupBox](qgroupbox.html)。當他們需要一個這種方法是有用的子類[QStyleOptionGroupBox](qstyleoptiongroupbox.html)，但不希望在所有的信息填寫自己。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（ ） 。 ``` bool QGroupBox.isCheckable (self) ``` ``` bool QGroupBox.isChecked (self) ``` ``` bool QGroupBox.isFlat (self) ``` ``` QSize QGroupBox.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（ ） 。 ``` QGroupBox.mouseMoveEvent (self, QMouseEvent?event) ``` 從重新實現[QWidget.mouseMoveEvent](qwidget.html#mouseMoveEvent)（ ） 。 ``` QGroupBox.mousePressEvent (self, QMouseEvent?event) ``` 從重新實現[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（ ） 。 ``` QGroupBox.mouseReleaseEvent (self, QMouseEvent?event) ``` 從重新實現[QWidget.mouseReleaseEvent](qwidget.html#mouseReleaseEvent)（ ） 。 ``` QGroupBox.paintEvent (self, QPaintEvent) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（ ） 。 ``` QGroupBox.resizeEvent (self, QResizeEvent) ``` 從重新實現[QWidget.resizeEvent](qwidget.html#resizeEvent)（ ） 。 ``` QGroupBox.setAlignment (self, int) ``` ``` QGroupBox.setCheckable (self, bool?b) ``` ``` QGroupBox.setChecked (self, bool?b) ``` 這種方法也是一個Qt槽與C + +的簽名`void setChecked(bool)`。 ``` QGroupBox.setFlat (self, bool?b) ``` ``` QGroupBox.setTitle (self, QString) ``` ``` QString QGroupBox.title (self) ``` * * * ## Qt Signal Documentation ``` void clicked (bool = 0) ``` 這是該信號的默認超載。 當復選框被激活（即按下然后釋放，而鼠標光標在按鈕內） ，或當快捷鍵打字，值得注意的是，該信號是這個信號被發射_not_如果你調用發出[setChecked](qgroupbox.html#checked-prop)（ ） 。 如果復選框被選中_checked_是真的，它是假的，如果未選中此復選框。 這個函數中引入了Qt 4.2中。 **See also** [checkable](qgroupbox.html#checkable-prop)，[toggled](qgroupbox.html#toggled)（）和[checked](qgroupbox.html#checked-prop)。 ``` void toggled (bool) ``` 這是該信號的默認超載。 如果該組框是可復，此信號時，該復選框被觸發發出。_on_是真的，如果該復選框被選中，否則為假。 **See also** [checkable](qgroupbox.html#checkable-prop)。