uic

The uic module contains functions for handling the .ui files created by Qt Designer that describe the whole or part of a graphical user interface. It includes functions that load a .ui file and render it directly, and functions that generate Python code from a .ui file for later execution.

PyQt6.uic.widgetPluginPath

The list of the directories that are searched for widget plugins. Initially it contains the name of the directory that contains the widget plugins included with PyQt6.

PyQt6.uic.compileUi(uifile, pyfile, execute=False, indent=4)

Generate a Python module that will create a user interface from a Qt Designer .ui file.

Parameters:

  • uifile (str) – the file name or file-like object containing the .ui file.

  • pyfile (file) – the file-like object to which the generated Python code will be written to.

  • execute (bool) – is optionally set if a small amount of additional code is to be generated that will display the user interface if the code is run as a standalone application.

  • indent (int) – the optional number of spaces used for indentation in the generated code. If it is zero then a tab character is used instead.

PyQt6.uic.compileUiDir(dir, recurse=False, map=None, max_workers=0, \*\*compileUi_args)

Create Python modules from Qt Designer .ui files in a directory or directory tree.

Parameters:

  • dir (str) – the name of the directory to scan for files whose name ends with :file`.ui`. By default the generated Python module is created in the same directory ending with .py.

  • recurse (bool) – is optionally set if any sub-directories should be scanned.

  • map (callable) – an optional callable that is passed the name of the directory containing the .ui file and the name of the Python module that will be created. The callable should return a tuple of the name of the directory in which the Python module will be created and the (possibly modified) name of the module.

  • max_workers (int) – is the maximum number of worker processes to use. A value of 0 means only the current process is used. A value of None means that the number of processors on the machine is used.

  • compileUi_args – are any additional keyword arguments that are passed to compileUi() that is called to create each Python module.

PyQt6.uic.loadUiType(uifile)

Load a Qt Designer .ui file and return a tuple of the generated form class and the Qt base class. These can then be used to create any number of instances of the user interface without having to parse the .ui file more than once.

Parameters:

uifile (str) – the file name or file-like object containing the .ui file.

Returns:

the form class and the Qt base class.

PyQt6.uic.loadUi(uifile, baseinstance=None, package='')

Load a Qt Designer .ui file and returns an instance of the user interface.

Parameters:

  • uifile (str) – the file name or file-like object containing the .ui file.

  • baseinstance – the optional instance of the Qt base class. If specified then the user interface is created in it. Otherwise a new instance of the base class is automatically created.

  • package (str) – the optional package that is the base package for any relative imports of custom widgets.

Returns:

the QWidget sub-class that implements the user interface.