Creación de ventanas principales en Qt Widgets Designer
Qt Widgets Designer se puede utilizar para crear interfaces de usuario con diferentes fines, y ofrece distintos tipos de plantillas de formulario para cada interfaz de usuario. La plantilla de ventana principal se utiliza para crear ventanas de aplicación con barras de menús, barras de herramientas y widgets acoplables.
Para crear una nueva ventana principal, abre el menú Archivo y selecciona la opción Nuevo formulario..., o pulsa Ctrl+N. A continuación, selecciona la plantilla Ventana principal. Esta plantilla proporciona una ventana principal de la aplicación que contiene, de forma predeterminada, una barra de menús y una barra de herramientas; estas pueden eliminarse si no son necesarias.
Si eliminas la barra de menús, puedes crear una nueva seleccionando la opción «Crear barra de menús» en el menú contextual, al que se accede haciendo clic con el botón derecho del ratón dentro del formulario de la ventana principal.
Una aplicación solo puede tener una barra de menús, pero sí varias barras de herramientas.
Menús
Los menús se añaden a la barra de menús modificando los marcadores de posición «Escribir aquí ». Uno de ellos siempre está presente para poder editarlo, y no se mostrará ni en la vista previa ni en la ventana final.
Una vez creado, se puede acceder a las propiedades de un menú mediante el Editor de propiedades, y se puede acceder a cada menú con este fin a través del Inspector de objetos.
Los menús existentes se pueden eliminar abriendo un menú contextual sobre la etiqueta de la barra de menús y seleccionando «Eliminar menú 'nombre_del_menú'».

Creación de un menú
Haz doble clic en el elemento marcador de posición para comenzar a editarlo. El texto del menú, que se muestra en un campo de edición de línea, se puede modificar.
Introduce el texto deseado para el nuevo menú. Al introducir el carácter «&», la letra que le sigue se utilizará como mnemotécnico para el menú.
Pulsa Retorno o Intro para aceptar el nuevo texto, o pulsa Esc para rechazarlo. Si es necesario, puedes deshacer la operación de edición más adelante.
Los menús también se pueden reorganizar en la barra de menús simplemente arrastrándolos y soltándolos en la ubicación deseada. Una línea roja vertical indica la posición en la que se insertará el menú.
Los menús pueden contener cualquier número de entradas y separadores, y pueden anidarse hasta la profundidad necesaria. Para añadir nuevas entradas a los menús, basta con navegar por la estructura del menú de la forma habitual.

Creación de una entrada de menú
Haz doble clic en el marcador de posición «Escribir aquí» para empezar a editar, o haz doble clic en «Añadir separador» para insertar una nueva línea separadora después de la última entrada del menú.
El texto de la entrada del menú se muestra en un campo de edición de línea y se puede modificar.
Introduce el texto deseado para la nueva entrada; si lo deseas, puedes utilizar el carácter «&» (ampersand) para indicar la letra que se utilizará como mnemotécnico para la entrada.
Pulsa Retorno o Intro para aceptar el nuevo texto, o pulsa Esc para rechazarlo. Se podrá acceder a la acción creada para esta entrada del menú a través del Editor de acciones, donde también se podrá configurar cualquier atajo de teclado asociado.
Al igual que con los menús, las entradas se pueden mover simplemente arrastrándolas y soltándolas en la ubicación deseada. Cuando se arrastra una entrada sobre un menú cerrado, este se abrirá para permitir su inserción en ese lugar. Dado que las entradas de menú se basan en acciones, también se pueden soltar en las barras de herramientas, donde se mostrarán como botones de la barra de herramientas.
Barras de herramientas

Crear y eliminar una barra de herramientas
Las barras de herramientas se añaden a la ventana principal de forma similar a la barra de menús: selecciona la opción «Añadir barra de herramientas» en el menú contextual del formulario. Como alternativa, si ya hay una barra de herramientas en la ventana principal, puedes hacer clic en la flecha situada en su extremo derecho para crear una nueva barra de herramientas.
Las barras de herramientas se eliminan del formulario mediante una opción del menú contextual de la barra de herramientas.
Añadir y eliminar botones de la barra de herramientas
Los botones de la barra de herramientas se crean como acciones en el Editor de acciones y se arrastran hasta la barra de herramientas. Dado que las acciones pueden representarse mediante opciones de menú y botones de la barra de herramientas, pueden desplazarse entre menús y barras de herramientas.

Para compartir una acción entre un menú y una barra de herramientas, arrastra su icono desde el Editor de acciones a la barra de herramientas, en lugar de hacerlo desde el menú en el que se encuentra su entrada. Consulta «Añadir una acción» para obtener más información sobre este proceso.
Los botones de la barra de herramientas se eliminan a través del menú contextual de la barra de herramientas.
Acciones
Una vez colocadas la barra de menús y las barras de herramientas, es el momento de añadirles acciones. Las nuevas acciones, tanto para los menús como para las barras de herramientas, se crean en la ventana del editor de acciones, lo que simplifica la creación y la gestión de las mismas.

El editor de acciones
Para activar el editor de acciones, abre el menú Herramientas y selecciona la opción «Editor de acciones ».
El editor de acciones te permite crear nuevas acciones y eliminar acciones. También ofrece una función de búsqueda, «Filtrar», que utiliza el texto de la acción.
Qt Widgets DesignerEl editor de acciones se puede visualizar en la vista clásica de iconos y en la vista detallada. La captura de pantalla que aparece a continuación muestra el editor de acciones en la vista detallada. También puedes copiar y pegar acciones entre menús, barras de herramientas y formularios.
Creación de una acción
Para crear una acción, utiliza el botón «Nuevo» del editor de acciones, lo que abrirá un cuadro de diálogo de entrada. Asigna un texto a la nueva acción: este es el texto que aparecerá en una entrada de menú y como información sobre herramientas de la acción. El texto también se añade automáticamente a un prefijo «acción», creando así el nombre del objeto de la acción.
Además, el cuadro de diálogo ofrece la opción de seleccionar un icono para la acción, así como de eliminar el icono actual.
Una vez creada la acción, se puede utilizar en cualquier lugar donde se puedan aplicar acciones.

Añadir una acción
Para añadir una acción a un menú o a una barra de herramientas, basta con pulsar el botón izquierdo del ratón sobre la acción en el editor de acciones y arrastrarla hasta la ubicación deseada.
Qt Widgets Designer El programa muestra unas líneas guía resaltadas que te indican dónde se añadirá la acción. Suelta el botón del ratón para añadir la acción cuando hayas encontrado el lugar adecuado.
Atraer widgets
Los widgets de acoplamiento también son widgets contenedores. Se pueden añadir a un formulario soltándolos en el área de acoplamiento deseada.

Añadir un widget del Dock
Para añadir un widget de acoplamiento a un formulario, arrastra uno desde la sección «Contenedores» del cuadro de widgets y suéltalo en el área principal del formulario. No añadas el widget de acoplamiento a un diseño ya existente. En su lugar, abre el Editor de propiedades y activa la propiedad «acoplado» para colocarlo en un área de acoplamiento.
Ten en cuenta que, en ocasiones, resulta más fácil configurar un widget acoplado si se añade a un formulario antes de aplicar un diseño al widget central. Por ejemplo, es posible desacoplarlo y cambiar su tamaño, lo que facilita la adición de widgets secundarios.
Los widgets acoplados pueden, opcionalmente, flotar como ventanas de herramientas independientes. Por lo tanto, resulta útil asignarles títulos de ventana configurando su propiedad « windowTitle ». Esto también ayuda a identificarlos en el formulario.
© 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.