Módulo 1: Bienvenida a Qt Designer
Qué es, para qué sirve y por qué un diseñador gráfico debería aprender a usarlo
Qué es, para qué sirve y por qué un diseñador gráfico debería aprender a usarlo
---
Objetivos de Aprendizaje
Al finalizar este módulo serás capaz de:
- Explicar qué es Qt Designer y para qué sirve
- Diferenciar Qt Designer de herramientas de diseño gráfico tradicionales
- Instalar Python, PySide6 y abrir Qt Designer correctamente
- Identificar los 5 paneles principales de la interfaz
- Comprender el flujo de trabajo diseñador → archivo .ui → aplicación
---
1.1 ¿Qué es Qt Designer?
Qt Designer es una aplicación visual que te permite crear interfaces de usuario (UI) para programas de escritorio arrastrando y soltando elementos, exactamente como diseñarías un poster en Illustrator o una maqueta en Figma.
Es parte del ecosistema Qt, un framework profesional usado por empresas como:
- Adobe (partes de Photoshop y Premiere)
- Tesla (pantallas de los vehículos)
- VLC Media Player (el reproductor completo)
- VirtualBox (toda la interfaz)
- Autodesk Maya (partes de la interfaz)
- Spotify (versiones de escritorio antiguas)
- WPS Office (suite de oficina)
- KDE Plasma (escritorio de Linux)
Miles de aplicaciones de escritorio en todo el mundo están construidas con Qt.
¿Para qué sirve Qt Designer?
| Uso | Descripción | Ejemplo |
|---|---|---|
| ----- | ------------- | --------- |
| **Diseñar ventanas y diálogos** | Crear la apariencia visual de aplicaciones de escritorio | Ventana principal de un editor de fotos |
| **Crear formularios** | Diseñar formularios de registro, contacto, configuración | Formulario de registro de usuarios |
| **Prototipar interfaces** | Prototipar rápidamente antes de programar | Mockup interactivo de una app |
| **Definir la experiencia de usuario (UX)** | Diseñar el flujo visual de forma interactiva | Wizard de instalación paso a paso |
¿Qué NO es Qt Designer?
- NO es un programa de dibujo → No pintas píxeles ni creas ilustraciones
- NO es una herramienta de edición de fotos → No retocas imágenes
- NO es un editor de código → No necesitas escribir código para usarlo
- NO es Figma/Photoshop → No creas imágenes estáticas, creas interfaces interactivas
---
1.2 Analogía Fundamental: Tu Mesa de Trabajo Digital
🎨 ANALOGÍA DEL DISEÑO
>
Piensa en Qt Designer como tu mesa de trabajo digital. Así como en Photoshop tienes capas, pinceles y herramientas organizadas en paneles, en Qt Designer tienes:
>
- Widgets (botones, textos, imágenes) → como tus elementos de diseño
- Propiedades (color, tamaño, fuente) → como tu panel de propiedades
- Un lienzo donde todo cobra vida → como tu canvas/artboard
>
La diferencia clave: en lugar de crear una imagen estática (PNG, JPG), estás creando una interfaz interactiva que una persona puede usar. Es como si tu diseño de Figma pudiera abrirse como una aplicación real.
Qt Designer vs. Herramientas que ya Conoces
| Concepto | Photoshop / Figma | Qt Designer |
|---|---|---|
| ---------- | ------------------- | ------------- |
| **Lienzo** | Canvas / Artboard | Form / Ventana |
| **Elementos** | Capas, formas, texto | Widgets (botones, labels, inputs) |
| **Propiedades** | Panel de propiedades | Property Editor |
| **Resultado** | Imagen estática (PNG, JPG, SVG) | Archivo .ui (interfaz interactiva) |
| **Interactividad** | Prototipos básicos (click-through) | Signals y Slots (interacción real) |
| **Responsive** | Manual (varios artboards) | Automático (con Layouts) |
| **Colaboración** | Compartir archivo .psd/.fig | Compartir archivo .ui |
🎨 ANALOGÍA DEL DISEÑO
>
Si Photoshop es como pintar un cuadro (resultado estático), Qt Designer es como diseñar el interior de una casa:
>
- Defines dónde va cada mueble (widget)
- Cómo se relacionan entre sí (layouts)
- Y qué pasa cuando alguien abre una puerta o enciende una luz (signals y slots)
---
1.3 El Ecosistema: ¿Cómo encaja todo?
┌─────────────────────────────────────────────────┐
│ TU ROL: DISEÑADOR │
│ │
│ Qt Designer (aplicación visual) │
│ │ │
│ ▼ │
│ Archivo .ui (tu diseño guardado) │
│ │ │
│ ▼ │
│ ─── Se entrega al programador ─── │
└─────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────┐
│ ROL DEL PROGRAMADOR │
│ │
│ Python + PySide6 │
│ │ │
│ ▼ │
│ Carga el archivo .ui │
│ │ │
│ ▼ │
│ Agrega la lógica (qué pasa al hacer clic) │
│ │ │
│ ▼ │
│ Aplicación funcional (.exe) │
└─────────────────────────────────────────────────┘
El archivo .ui
Cuando guardas tu diseño en Qt Designer, se crea un archivo con extensión .ui. Este archivo es XML (texto estructurado) que describe:
- Cada widget que colocaste
- Su posición y tamaño
- Sus propiedades (color, texto, fuente, etc.)
- Las conexiones entre widgets (signals y slots)
🎨 ANALOGÍA DEL DISEÑO
>
El archivo .ui es como tu archivo .psd o .fig: contiene todo tu diseño editable. La diferencia es que en lugar de ser un formato propietario cerrado, es XML abierto que cualquier programa puede leer.
---
1.4 Instalación Paso a Paso
Paso 1: Instalar Python
Python es el lenguaje de programación que ejecutará tu aplicación. Qt Designer viene incluido con PySide6 (el paquete de Python para Qt).
- Ve a [python.org](https://www.python.org/downloads/)
- Descarga la última versión de Python 3 (3.8 o superior)
- Ejecuta el instalador
- IMPORTANTE: Marca la casilla "Add Python to PATH" antes de instalar
- Haz clic en "Install Now"
Verificar instalación:
Abre la terminal (CMD en Windows, Terminal en macOS/Linux) y escribe:
python --version
Deberías ver algo como Python 3.12.x.
Paso 2: Instalar PySide6
PySide6 es el paquete que incluye Qt Designer y todas las herramientas de Qt para Python.
pip install PySide6
Esto descargará e instalará:
- PySide6 → Las bibliotecas de Qt para Python
- pyside6-designer → Qt Designer (la aplicación que usarás)
- pyside6-uic → Herramienta para convertir .ui a Python
Verificar instalación:
pyside6-designer --version
Paso 3: Abrir Qt Designer
Para abrir Qt Designer, ejecuta en la terminal:
pyside6-designer
Se abrirá una ventana con el título "New Form" preguntándote qué tipo de ventana quieres crear.
💡 CONSEJO: Puedes crear un acceso directo en tu escritorio al ejecutable
pyside6-designer.exepara no tener que abrirlo desde la terminal cada vez. En Windows, búscalo enC:\Users\TU_USUARIO\AppData\Local\Programs\Python\PythonXX\Scripts\pyside6-designer.exe.
---
1.5 Primer Contacto con Qt Designer
Al abrir Qt Designer por primera vez, verás el diálogo "New Form" con estas opciones:
| Tipo de Ventana | Descripción | Cuándo usarlo |
|---|---|---|
| ----------------- | ------------- | --------------- |
| **Dialog with Buttons Bottom** | Ventana emergente con botones OK/Cancel abajo | Configuración rápida, confirmaciones |
| **Dialog without Buttons** | Ventana emergente sin botones predefinidos | Diseños personalizados (recomendado para empezar) |
| **Dialog with Buttons Right** | Ventana emergente con botones a la derecha | Asistentes, wizards |
| **Main Window** | Ventana principal completa con menú y toolbar | Aplicaciones completas |
| **Widget** | Componente reutilizable | Partes de una interfaz más grande |
💡 CONSEJO: Para tus primeros ejercicios, selecciona "Dialog without Buttons". Es el lienzo más simple y te permite concentrarte en aprender sin distracciones.
---
1.6 Los 5 Paneles de Qt Designer
Cuando seleccionas un tipo de ventana y haces clic en "Create", verás la interfaz completa de Qt Designer. Está dividida en 5 paneles principales:
1. Widget Box (Caja de Widgets) — Panel Izquierdo
Es tu paleta de herramientas. Aquí encuentras todos los elementos disponibles organizados por categorías:
- Spacers → Espacios flexibles invisibles
- Buttons → Botones de todo tipo
- Display Widgets → Labels, imágenes, barras de progreso
- Input Widgets → Campos de texto, selectores, sliders
- Containers → Group Box, Tab Widget, Stacked Widget
- Item Widgets → Listas, tablas, árboles
🎨 ANALOGÍA DEL DISEÑO
>
El Widget Box es como tu caja de herramientas física de diseñador: ahí están tus pinceles, reglas, cutter, etc. Pero en lugar de herramientas de dibujo, son "piezas de interfaz" listas para usar.
2. Object Inspector (Inspector de Objetos) — Panel Superior Derecho
Muestra la jerarquía de elementos de tu diseño, como el panel de Capas en Photoshop.
Aquí puedes:
- Ver qué widget está dentro de cuál
- Renombrar widgets
- Reorganizar la jerarquía
- Seleccionar widgets difíciles de alcanzar
3. Property Editor (Editor de Propiedades) — Panel Inferior Derecho
Es el panel más importante. Muestra todas las propiedades del widget seleccionado:
- QObject → Nombre interno (objectName)
- QWidget → Propiedades visuales (enabled, geometry, font, cursor, styleSheet, etc.)
- Propiedades específicas → text (para Labels), pixmap (para imágenes), etc.
🎨 ANALOGÍA DEL DISEÑO
>
El Property Editor es como el panel de Propiedades de Illustrator o el panel de Diseño de Figma: ahí cambias colores, tamaños, fuentes, efectos, etc.
4. Resource Browser (Navegador de Recursos) — Panel Opcional
Aquí gestionas tus imágenes, iconos y archivos que usarás en el diseño.
🎨 ANALOGÍA DEL DISEÑO
>
Similar al panel de Bibliotecas de Adobe Creative Cloud o los Assets de Figma: tus recursos reutilizables organizados.
5. Área de Trabajo (Form/Canvas) — Centro
Tu lienzo principal. Aquí arrastras y sueltas los widgets para construir tu interfaz.
🎨 ANALOGÍA DEL DISEÑO
>
Es tu artboard de Figma o tu canvas de Photoshop: el espacio donde todo se une.
---
1.7 Atajos de Teclado Esenciales
| Atajo | Función |
|---|---|
| ------- | --------- |
| `Ctrl+N` | Nuevo archivo |
| `Ctrl+S` | Guardar archivo |
| `Ctrl+O` | Abrir archivo |
| `Ctrl+Z` | Deshacer |
| `Ctrl+Y` | Rehacer |
| `Ctrl+C` | Copiar widget |
| `Ctrl+V` | Pegar widget |
| `Delete` | Eliminar widget seleccionado |
| `F3` | Modo edición normal |
| `F4` | Modo edición Signals/Slots |
| `Ctrl+L` | Aplicar Layout Vertical |
| `Ctrl+H` | Aplicar Layout Horizontal |
| `Ctrl+J` | Aplicar Layout en Grid |
---
1.8 Tu Primer Diseño: "Hola Mundo" Visual
Vamos a crear algo simple para que entiendas el flujo de trabajo básico.
Paso a paso:
- Abre Qt Designer y selecciona "Dialog without Buttons"
- Haz clic en "Create"
- En el Widget Box (izquierda), busca la sección Display Widgets
- Arrastra un Label al área de trabajo
- Con el Label seleccionado, ve al Property Editor (derecha abajo)
- Busca la propiedad text y cambia "TextLabel" por "¡Hola Mundo!"
- Busca la propiedad font y haz clic en el botón
...para cambiar tamaño y estilo - Ahora arrastra un Push Button desde la sección Buttons
- Cambia su texto a "Cerrar"
- Guarda el archivo como hola_mundo.ui (
Ctrl+S)
🎨 ANALOGÍA DEL DISEÑO
>
Acabas de hacer el equivalente a crear un documento nuevo en Photoshop, agregar un texto y un botón. La diferencia es que este "diseño" puede convertirse en una ventana real de una aplicación.
---
Ejercicio Práctico del Módulo
🏋️ EJERCICIO 1: Mi Primera UI
>
Objetivo: Crear tu primera interfaz funcional y familiarizarte con Qt Designer.
>
Pasos:
1. Instala Python desde python.org (marca "Add to PATH")
2. Abre la terminal y ejecuta
pip install PySide63. Ejecuta
pyside6-designerpara abrir la aplicación4. Explora libremente la interfaz durante 5 minutos sin miedo a romper nada
5. Crea un Dialog sin botones
6. Agrega un Label con tu nombre como texto
7. Cambia la fuente del Label a algo grande y llamativo (24pt, negrita)
8. Agrega un Push Button con el texto "Salir"
9. Cambia el color de fondo del Dialog (propiedad
styleSheet:background-color: #1a1a2e;)10. Cambia el color del texto del Label a verde (
#41CD52)11. Guarda como
mi_primera_ui.ui
>
Resultado esperado: Una ventana oscura con tu nombre en verde grande y un botón de salir.
---
Recursos Adicionales
| Recurso | Descripción | Enlace |
|---|---|---|
| --------- | ------------- | -------- |
| Documentación oficial de Qt Designer | Manual completo de Qt Designer | [doc.qt.io/qt-6/qtdesigner-manual.html](https://doc.qt.io/qt-6/qtdesigner-manual.html) |
| PySide6 Documentation | Documentación oficial de PySide6 | [doc.qt.io/qtforpython-6/](https://doc.qt.io/qtforpython-6/) |
| Python.org | Descargar Python | [python.org](https://www.python.org/downloads/) |
| Qt Widgets Gallery | Galería visual de todos los widgets | [doc.qt.io/qt-6/gallery.html](https://doc.qt.io/qt-6/gallery.html) |
---
Evaluación de Comprensión
Responde estas preguntas para verificar que entendiste el módulo:
- ¿Qué es Qt Designer y para qué sirve?
- ¿Cuál es la diferencia principal entre Qt Designer y Photoshop?
- ¿Qué es un archivo .ui y a qué archivo de diseño gráfico se parece?
- ¿Cuáles son los 5 paneles principales de Qt Designer?
- ¿Qué tipo de ventana recomendarías para empezar a practicar?
- ¿Qué comando se usa para abrir Qt Designer desde la terminal?
- ¿Qué propiedad del Property Editor usarías para cambiar el texto de un Label?
---
Siguiente módulo: → [Módulo 2: Tu Primera Interfaz](01-primera-interfaz.md)
Escribe tus respuestas y luego presiona el botón para comparar con las respuestas correctas.
Ejercicio 1: Instalación y Primer Arranque
Módulo 1: Bienvenida a Qt Designer
---
Objetivo
Instalar todas las herramientas necesarias y abrir Qt Designer por primera vez.
---
Requisitos Previos
- Computadora con Windows, macOS o Linux
- Conexión a internet para descargar Python
---
Instrucciones Paso a Paso
Paso 1: Instalar Python
- Abre tu navegador y ve a [python.org](https://www.python.org/downloads/)
- Haz clic en el botón amarillo "Download Python 3.x.x"
- Ejecuta el instalador descargado
- IMPORTANTE: Antes de hacer clic en "Install Now", marca la casilla:
- ✅ "Add Python to PATH" (en Windows)
- Haz clic en "Install Now"
- Espera a que termine la instalación
- Haz clic en "Close"
Paso 2: Verificar la instalación de Python
- Abre la terminal:
- Windows: Presiona
Win + R, escribecmdy presiona Enter - macOS: Abre la aplicación "Terminal"
- Linux: Abre tu terminal favorita
- Escribe el siguiente comando y presiona Enter:
python --version
- Deberías ver algo como:
Python 3.12.x
⚠️ Si ves un error: En Windows, intenta con
python3 --version. Si ninguno funciona, reinstala Python asegurándote de marcar "Add Python to PATH".
Paso 3: Instalar PySide6
- En la misma terminal, escribe:
pip install PySide6
- Espera a que se descargue e instale (puede tardar unos minutos)
- Deberías ver mensajes de instalación exitosa
Paso 4: Verificar la instalación de PySide6
pyside6-designer --version
Deberías ver la versión de Qt Designer.
Paso 5: Abrir Qt Designer
pyside6-designer
Se abrirá la ventana de Qt Designer con el diálogo "New Form".
Paso 6: Exploración libre (5 minutos)
- Selecciona "Dialog without Buttons" y haz clic en "Create"
- Explora los paneles:
- ¿Puedes ver el Widget Box a la izquierda?
- ¿Puedes ver el Object Inspector arriba a la derecha?
- ¿Puedes ver el Property Editor abajo a la derecha?
- Arrastra un Label al área de trabajo
- Cambia su texto en el Property Editor
- Arrastra un botón
- Cambia su texto
- Cierra Qt Designer (no necesitas guardar)
Paso 7: Volver a abrir
- Abre Qt Designer nuevamente con
pyside6-designer - Esta vez selecciona "Main Window" y haz clic en "Create"
- Observa la diferencia con el Dialog
- Cierra Qt Designer
---
Resultado Esperado
- Python instalado y funcionando
- PySide6 instalado correctamente
- Qt Designer se abre sin errores
- Has explorado la interfaz de Qt Designer
---
Solución de Problemas
| Problema | Solución |
|---|---|
| ---------- | ---------- |
| `python: command not found` | Reinstala Python marcando "Add Python to PATH" |
| `pip: command not found` | Usa `python -m pip install PySide6` |
| `pyside6-designer: command not found` | Usa `python -m PySide6.Designer` |
| Qt Designer no abre | Verifica que PySide6 se instaló correctamente con `pip show PySide6` |
---
¿Qué sigue?
Una vez completado este ejercicio, continúa con el Módulo 2: Tu Primera Interfaz y el Ejercicio 2: Mi Primera UI.