{"id":5078,"date":"2022-09-23T10:34:42","date_gmt":"2022-09-23T10:34:42","guid":{"rendered":"https:\/\/www.pythontutorial.net\/?page_id=5078"},"modified":"2022-10-29T08:04:14","modified_gmt":"2022-10-29T08:04:14","slug":"pyqt-qgroupbox","status":"publish","type":"page","link":"https:\/\/www.pythontutorial.net\/pyqt\/pyqt-qgroupbox\/","title":{"rendered":"PyQt QGroupBox"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll learn how to use the PyQt QGroupBox<\/code> class to create a group box frame with a title.<\/p>\n\n\n\n

Introduction to the PyQt QGroupBox widget #<\/a><\/h2>\n\n\n\n

A group box allows you to group related widgets together in a frame with a title on top. To create a group box widget, you use the QWidget<\/code> class:<\/p>\n\n\n

group_box = QGroupBox(title)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Because a group box doesn’t automatically lay out the child widgets, to add widgets to the group box, you need to create a layout object first:<\/p>\n\n\n
layout = QVBoxLayout()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
set the layout for the group box:<\/p>\n\n\n
group_box.setLayout(layout)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
and use the layout object to add the child widgets:<\/p>\n\n\n
layout.addWidget(widget1)\nlayout.addWidget(widget2)\nlayout.addWidget(widget3)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Here are the complete steps for creating a group box and adding child widgets to it:<\/p>\n\n\n
# Create a group box<\/span>\ngroup_box - QGroupBox(title)\n\n# create a layout and set it for the group box<\/span>\nlayout = QVBoxLayout()\ngroup_box.setLayout(layout)\n\n# add widgets to the layout<\/span>\nlayout.addWidget(widget1)\nlayout.addWidget(widget2)\nlayout.addWidget(widget3)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
PyQt QGroupBox widget example #<\/a><\/h2>\n\n\n\n
The following example uses the QGroupBox<\/code> class to create group box widgets:<\/p>\n\n\n
import<\/span> sys\nfrom<\/span> PyQt6.QtWidgets import<\/span> QApplication, QWidget,  QFormLayout, QPushButton, QGroupBox, QLineEdit, QDateEdit\nfrom<\/span> PyQt6.QtCore import<\/span> Qt\n\n\nclass<\/span> MainWindow<\/span>(QWidget)<\/span>:<\/span>\n    def<\/span> __init__<\/span>(self, *args, **kwargs)<\/span>:<\/span>\n        super().__init__(*args, **kwargs)\n\n        self.setWindowTitle('PyQt QGroupBox'<\/span>)\n\n        layout = QFormLayout(self)\n        self.setLayout(layout)\n\n        person_groupbox = QGroupBox('Personal Information'<\/span>)\n        form_layout = QFormLayout()\n        person_groupbox.setLayout(form_layout)\n\n        form_layout.addRow('First Name:'<\/span>, QLineEdit(person_groupbox))\n        form_layout.addRow('Last Name:'<\/span>, QLineEdit(person_groupbox))\n        form_layout.addRow('DOB:'<\/span>, QDateEdit(person_groupbox))\n\n        contact_groupbox = QGroupBox('Contact Information'<\/span>)\n        form_layout = QFormLayout()\n        contact_groupbox.setLayout(form_layout)\n        form_layout.addRow('Phone Number:'<\/span>, QLineEdit(contact_groupbox))\n        form_layout.addRow('Email Address:'<\/span>, QLineEdit(contact_groupbox))\n\n        layout.addWidget(person_groupbox)\n        layout.addWidget(contact_groupbox)\n        layout.addWidget(QPushButton('Save'<\/span>))\n\n        # show the window<\/span>\n        self.show()\n\n\nif<\/span> __name__ == '__main__'<\/span>:\n    app = QApplication(sys.argv)\n    window = MainWindow()\n    sys.exit(app.exec())<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
How it works.<\/p>\n\n\n\n
First, create a group box with a title 'Personal Information'<\/code>:<\/p>\n\n\n
person_groupbox = QGroupBox('Personal Information'<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Next, create a form layout and set it as the layout of the group box:<\/p>\n\n\n
form_layout = QFormLayout()\nperson_groupbox.setLayout(form_layout)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Then, add widgets to the form layout of the group box:<\/p>\n\n\n
form_layout.addRow('First Name:'<\/span>, QLineEdit(person_groupbox))\nform_layout.addRow('Last Name:'<\/span>, QLineEdit(person_groupbox))\nform_layout.addRow('DOB:'<\/span>, QDateEdit(person_groupbox))<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
After that, create the second group box:<\/p>\n\n\n
contact_groupbox = QGroupBox('Contact Information'<\/span>)\nform_layout = QFormLayout()\ncontact_groupbox.setLayout(form_layout)\nform_layout.addRow('Phone Number:'<\/span>, QLineEdit(contact_groupbox))\nform_layout.addRow('Email Address:'<\/span>, QLineEdit(contact_groupbox))<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Finally, place the group boxes in the main window:<\/p>\n\n\n
layout.addWidget(person_groupbox)\nlayout.addWidget(contact_groupbox)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Summary #<\/a><\/h2>\n\n\n\n
  • Use PyQt QGroupBox<\/code> class to create a group box widget.<\/li><\/ul>\n
    \n\t
    \n\t\t
    Was this tutorial helpful ?<\/div>\n\t\t
    \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
    \n\t\t
    \n\t\t\t
    <\/div>\n\t\t\t