Cómo Usar Python y Qt Designer

3 minuto(s)

En esta página:

El lenguaje de programación Python junto con la herramienta Qt Designer (basada en Qt framework).

Esta genial combinación, te permite crear interfaces de usuario (GUI) para tus proyectos.

En este tutorial aprenderás a Cómo Usar Python y Qt Designer, vamos con ello.

Pasos para Usar Python y Qt Designer

Sigue los siguiente pasos a continuación:

Requerimientos

Python 3
PyQt
Qt Designer

1. Instala los paquetes necesarios


# Comando para instalar PyQt5 y sus herramientas 
pip install pyqt5 pyqt5-tools

# Comando para instalar PyQt5 y sus herramientas

pip install pyqt5 pyqt5-tools

Si estás usando la versión más reciente de Python, que suele ser muy nueva, puede que no sea compatible aún oficialmente con muchas bibliotecas, incluyendo PyQt. Te recomiendo usar una versión anterior de Python, por ejemplo si salió la versión de Python 3.13, es mejor usar Python 3.10 o 3.11 con PyQt.

2. Abre Qt Designer

Busca el archivo designer.exe en:


C:\Users\a\AppData\Local\Programs\Python\Python311\Lib\site-packages\qt5_applications\Qt\bin\

C:\Users\a\AppData\Local\Programs\Python\Python311\Lib\site-packages\qt5_applications\Qt\bin\

Estoy trabajando con Windows 11 de 64 bits y tuve que mostrar elementos ocultos en el explorador de archivos para poder encontrar el archivo designer.exe

Interfaz de Qt Designer — Nos aparece una ventana para crear un nuevo formulario

3. Crea una interfaz

Aquí vamos a crear nuestro diseño:

1. Abre Qt Designer.

2. Elige un tipo de ventana: Main Window, Dialog, Widget, etc. (yo elegí Main Window).

3. Diseña tu interfaz arrastrando widgets (botones, etiquetas, etc.):

Creando la interfaz en Qt Designer — He arrastrado un Text Edit y un Push Button

4. Guarda el archivo como: ventana.ui (colocale el nombre que desees, pero que tenga siempre la extensión .ui)

4. Convierte el archivo ventana.ui a ventana.py

Con PyQt5 podemos hacerlo ejecutando el siguiente comando en nuestra terminal:


pyuic5 ventana.ui -o ventana.py

pyuic5 ventana.ui -o ventana.py

No verás nada en la terminal, pero si encontrarás el archivo ventana.py creado en la ubicación del archivo ventana.ui

5. Usa la interfaz en tu código Python

En mi interfaz he creado un textEdit con nombre textEdit y un pushButton con nombre pushButton, estos nombres los uso en el siguiente código Python.

Te dejo un ejemplo básico con PyQt5 (app.py):


import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
from ventana import Ui_MainWindow  # generado con pyuic5

class MiVentana(QMainWindow):
    def __init__(self):
        super().__init__()
        self.ui = Ui_MainWindow()
        self.ui.setupUi(self)

        # Conectar el botón a una función
        self.ui.pushButton.clicked.connect(self.saludar)

    def saludar(self):
        texto = self.ui.textEdit.toPlainText()  # Obtener texto del QTextEdit
        self.ui.textEdit.setPlainText(f"Hola {texto}")  # Escribir texto de vuelta

if __name__ == '__main__':
    app = QApplication(sys.argv)
    ventana = MiVentana()
    ventana.show()
    sys.exit(app.exec_())

import sys

from PyQt5.QtWidgets import QApplication, QMainWindow

from ventana import Ui_MainWindow # generado con pyuic5

class MiVentana(QMainWindow):

def __init__(self):

super().__init__()

self.ui = Ui_MainWindow()

self.ui.setupUi(self)

# Conectar el botón a una función

self.ui.pushButton.clicked.connect(self.saludar)

def saludar(self):

texto = self.ui.textEdit.toPlainText() # Obtener texto del QTextEdit

self.ui.textEdit.setPlainText(f"Hola {texto}") # Escribir texto de vuelta

if __name__ == '__main__':

app = QApplication(sys.argv)

ventana = MiVentana()

ventana.show()

sys.exit(app.exec_())

6. Ejecuta tu app

Con el siguiente comando:


python app.py

python app.py

Obtenemos nuestra interfaz de usuario:

Interfaz creada con Qt Designer — No borrer el archivo ventana.py ya que es necesario para que el proyecto funcione

Consejos

Usa nombres de objeto útiles en Qt Designer (objectName) para poder referenciar botones, etiquetas, etc.
Puedes conectar señales (clicked, textChanged, etc.) a funciones en Python.
Qt Designer solo diseña interfaces; toda la lógica debe estar en Python.