Widgets Tutorial - Creating a Window

If a widget is created without a parent, it is treated as a window, or top-level widget, when it is shown. Since it has no parent object to ensure that it is deleted when no longer needed, it is up to the developer to keep track of the top-level widgets in an application.

In the following example, we use QWidget to create and show a window with a default size:

from PySide6 import QtWidgets
if __name__ == "__main__":

    app = QApplication([])
//! [create, resize and show]
    window = QWidget()
    window.resize(320, 240)
//! [create, resize and show]
        QApplication.translate("toplevel", "Top-level widget"))


To create a real GUI, we need to place widgets inside the window. To do this, we pass a QWidget instance to a widget’s constructor, as we will demonstrate in the next part of this tutorial.

Example project @ code.qt.io