{"id":5056,"date":"2022-09-22T08:07:52","date_gmt":"2022-09-22T08:07:52","guid":{"rendered":"https:\/\/www.pythontutorial.net\/?page_id=5056"},"modified":"2022-10-14T03:41:41","modified_gmt":"2022-10-14T03:41:41","slug":"pyqt-qformlayout","status":"publish","type":"page","link":"https:\/\/www.pythontutorial.net\/pyqt\/pyqt-qformlayout\/","title":{"rendered":"PyQt QFormLayout"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll learn how to use PyQt QFormLayout<\/code> to arrange widgets in a form.<\/p>\n\n\n\n

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

When creating a data-entry form, you often need to place fields in rows. And on each row, you place a label next to an input widget.<\/p>\n\n\n\n

PyQt provides you with a convenient two-column form that arranges the widgets on a form. The left column has a label and the right column has an input widget.<\/p>\n\n\n\n

To create a form layout, you use QFormLayout<\/code> class:<\/p>\n\n\n

layout = QFormLayout(self)\nself.setLayout(layout) # self is the parent widget<\/span><\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Adding widgets to the form layout can be done with the addRow()<\/code> method. For example:<\/p>\n\n\n
layout.addRow('Field 1'<\/span>, input_widget1)\nlayout.addRow('Field 2'<\/span>, input_widget2)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
The addRow()<\/code> method takes a string and a widget and automatically creates the QLabel<\/code> widget for the string.<\/p>\n\n\n\n
Besides providing conveniences, QFormLayout<\/code> adheres to the platform’s look and feel guidelines. For example, when used on macOS labels are right-justified while when used on Windows, labels are left-justified.<\/p>\n\n\n\n
In addition, when displayed on a narrow screen, the layout automatically collapses to a single column with labels above the input widgets.<\/p>\n\n\n\n
PyQt QFormLayout example #<\/a><\/h2>\n\n\n\n
The following example shows how to create a signup form using the QFormLayout<\/code>:<\/p>\n\n\n
import<\/span> sys\nfrom<\/span> PyQt6.QtWidgets import<\/span> QApplication, QWidget, QPushButton, QLineEdit,  QFormLayout\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('Sign Up Form'<\/span>)\n\n        layout = QFormLayout()\n        self.setLayout(layout)\n\n        layout.addRow('Name:'<\/span>, QLineEdit(self))\n        layout.addRow('Email:'<\/span>, QLineEdit(self))\n        layout.addRow('Password:'<\/span>, QLineEdit(self, echoMode=QLineEdit.EchoMode.Password))\n        layout.addRow('Confirm Password:'<\/span>, QLineEdit(self, echoMode=QLineEdit.EchoMode.Password))\n        layout.addRow('Phone:'<\/span>, QLineEdit(self))\n\n        layout.addRow(QPushButton('Sign Up'<\/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
Summary #<\/a><\/h2>\n\n\n\n
  • Use PyQt QFormLayout<\/code> to create data-entry forms.<\/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
If you pass a single widget such as a QLabel<\/a><\/code>, the widget will automatically span both columns. In practice, you can use this feature for creating headings or section labels.<\/p>\n\n\n\n