Uso de un archivo de interfaz de usuario de « Qt Widgets Designer » en tu aplicación de « Qt for Python »
Conversión del formulario a código Python
A modo de ejemplo, utilizaremos el ejemplo de suavizado de animaciones de Qt Widgets.
La aplicación consta de un archivo fuente, easing.py, un archivo de interfaz de usuario form.ui y el archivo de proyecto, pyproject.toml, en formato TOML:
[project]
name = "Easing Example"
[tool.pyside6-project]
files = ["easing.py", "form.ui"]El archivo de interfaz de usuario se convierte en código Python que crea el formulario utilizando User Interface Compiler (uic):
uic -g python form.ui > ui_form.pyDado que el widget de nivel superior se denomina « Form », esto da lugar a la generación de una clase de Python denominada « Ui_Form ». Esta clase proporciona una función « setupUi() », que toma el widget como parámetro y se invoca para crear los elementos de la interfaz de usuario:
from ui_form import Ui_Form
...
class Window(QtWidgets.QWidget):
def __init__(self, parent=None):
super(Window, self).__init__(parent)
self.m_ui = Ui_Form()
self.m_ui.setupUi(self)Posteriormente, se puede acceder a los widgets a través de la clase ` Ui_Form `:
self.m_ui.graphicsView.setScene(self.m_scene)Además de setupUi(), Ui_Form proporciona otro método retranslateUi(), que puede invocarse en respuesta a un QEvent de tipo QEvent.LanguageChange, lo que indica un cambio en el idioma de la aplicación.
El enfoque de UiTools
La clase QUiLoader proporciona un objeto cargador de formularios para construir la interfaz de usuario en tiempo de ejecución. Esta interfaz de usuario se puede recuperar desde cualquier QIODevice, por ejemplo, un objeto QFile. La función QUiLoader::load() construye el widget del formulario utilizando la descripción de la interfaz de usuario contenida en el archivo.
Esto se ilustra en el ejemplo uiloader:
from PySide6.QtUiTools import QUiLoader
if __name__ == '__main__':
# Some code to obtain the form file name, ui_file_name
app = QApplication(sys.argv)
ui_file = QFile(ui_file_name)
if not ui_file.open(QIODevice.OpenModeFlag.ReadOnly):
print(f"Cannot open {ui_file_name}: {ui_file.errorString()}")
sys.exit(-1)
loader = QUiLoader()
widget = loader.load(ui_file, None)
ui_file.close()
if widget is None:
print(loader.errorString())
sys.exit(-1)
widget.show()
sys.exit(app.exec())Importación de recursos
Uso de un único directorio
Al utilizar iconos de archivos de recursos, por ejemplo resources.qrc, uic generará una importación con el siguiente formato:
import resources_rcEsto supone que existe un archivo resources_rc.py, generado al ejecutar la herramienta Resource Compiler (rcc) (pasando la opción de línea de comandos -g python ), en el mismo directorio que el código fuente del formulario.
uic tiene una opción de línea de comandos --rc-prefix que hace que se anteponga el indicador rc:
import rc_resourcesLa opción de línea de comandos --from-imports hace que las importaciones se generen de forma relativa a «.»:
from . import resources_rcÁrboles de directorios
Algunos proyectos tienen árboles de directorios más complicados, por ejemplo:
project
resources (resources.qrc)
ui (.ui files)En ese caso, el archivo de recursos no se encuentra en el mismo directorio que el código fuente del formulario y los archivos « .ui » suelen tener rutas relativas a los archivos de recursos:
<include location="../resources/resources.qrc"/>En este caso, se puede utilizar la opción de línea de comandos ` --absolute-imports ` para generar una importación absoluta en Python, lo que da como resultado:
import resources.resources_rcpartiendo de la suposición de que ` ..` es el directorio raíz del proyecto incluido en la lista de rutas de importación de Python.
Para árboles con un anidamiento mayor, es posible utilizar la opción de línea de comandos ` --python-paths <path list> ` para pasar una lista de rutas de importación de Python. A continuación, ` uic ` intentará determinar la raíz del proyecto comparando la ruta del archivo de formulario con los componentes de la ruta.
Si no se especifica « --python-paths », se comprueba por defecto la variable de entorno « PYTHONPATH ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.