En esta página

Tutorial sobre widgets

Introducción

Los widgets son los componentes básicos de las aplicaciones con interfaz gráfica de usuario (GUI) creadas con Qt. Cada componente de la GUI (por ejemplo, botones, etiquetas o editores de texto) es un objeto de clase ` widget ` que se coloca en algún lugar dentro de una ventana de la interfaz de usuario o se muestra como una ventana independiente. Cada tipo de widget está implementado por una subclase de ` QWidget`, que a su vez es una subclase de ` QObject`.

QWidget no es una clase abstracta. Se puede utilizar como contenedor para otros widgets y se pueden crear subclases a partir de ella con un mínimo esfuerzo para crear nuevos widgets personalizados. QWidget se utiliza a menudo para crear una ventana en cuyo interior se colocan otros QWidget.

Al igual que con los QObject, los QWidgetpueden crearse con objetos padres para indicar la propiedad, lo que garantiza que los objetos se eliminen cuando ya no se utilicen. En el caso de los widgets, estas relaciones padre-hijo tienen un significado adicional: cada widget hijo se muestra dentro del área de la pantalla ocupada por su widget padre. Esto significa que, al eliminar un widget de ventana, también se eliminan todos los widgets hijos que contiene.

Escribir una función «main»

Muchos de los ejemplos de interfaz gráfica de usuario (GUI) que se incluyen con Qt siguen el patrón de contar con un archivo « main.cpp », que contiene el código estándar para inicializar la aplicación, además de cualquier número de otros archivos fuente o de cabecera que contengan la lógica de la aplicación y los componentes personalizados de la interfaz gráfica de usuario.

Una función típica de ` main() ` en ` main.cpp ` tiene este aspecto:

#include <QtWidgets>

// Include header files for application components.
// ...

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    // Set up and show widgets.
    // ...

    return app.exec();
}

En primer lugar, se crea un objeto ` QApplication `, que puede configurarse con argumentos pasados desde la línea de comandos. Una vez creados y mostrados los widgets, se llama a ` QApplication::exec()` para iniciar el bucle de eventos de Qt. El control pasa a Qt hasta que esta función devuelve un valor. Por último, ` main() ` devuelve el valor devuelto por ` QApplication::exec()`.

Ejemplos sencillos de widgets

Cada uno de estos ejemplos sencillos de widgets está escrito íntegramente dentro de la función main().

Ejemplos de widgets del mundo real

En estos ejemplos más avanzados, el código que crea los widgets y los diseños se almacena en otros archivos. Por ejemplo, la interfaz gráfica de usuario de una ventana principal puede crearse en el constructor de una subclase de ` QMainWindow `.

Compilación de los ejemplos

Si has instalado un paquete binario para obtener Qt, o si has compilado Qt tú mismo, los ejemplos descritos en este tutorial ya deberían estar compilados y listos para ejecutarse. Si deseas modificarlos y recompilarlos, sigue estos pasos:

  1. Desde una línea de comandos, accede al directorio que contiene el ejemplo que has modificado.
  2. Escribe ` qmake ` y pulsa ` Return`. Si esto no funciona, asegúrate de que el ejecutable se encuentra en tu ruta de acceso o introduce su ubicación completa.
  3. En Linux/Unix y macOS, escribe « make » y pulsa « Return »; en Windows con Visual Studio, escribe « nmake » y pulsa « Return ».

Se creará un archivo ejecutable en el directorio actual. En Windows, este archivo puede encontrarse en un subdirectorio llamado « debug » o « release ». Puede ejecutar este ejecutable para ver el código de ejemplo en funcionamiento.

© 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.