Uso de contenedores en Qt Widgets Designer

Los widgets contenedores proporcionan un alto nivel de control sobre grupos de objetos en un formulario. Se pueden utilizar para realizar diversas funciones, como gestionar widgets de entrada, proporcionar diseños paginados y con pestañas, o simplemente actuar como contenedores decorativos para otros objetos.

Captura de pantalla en la que se muestran las opciones «Transformar en» de un botón. Se muestran las opciones para transformarlo en QCheckbox, QRadioButton, QToolButton y QCommandLinkButton.

Qt Widgets Designer proporciona indicación visual para ayudarte a colocar objetos dentro de tus contenedores. Cuando arrastras un objeto desde el cuadro de widgets (o desde cualquier otro lugar) al formulario, cada contenedor se resaltará al situar el cursor sobre él. Esto indica que puede soltar el objeto en su interior, convirtiéndolo en un objeto hijo del contenedor. Esta indicación es importante porque es fácil colocar objetos cerca de los contenedores sin llegar a situarlos realmente en su interior. Tanto los widgets como los espaciadores pueden utilizarse dentro de los contenedores.

Los widgets apilados, los widgets de pestañas y las cajas de herramientas se gestionan de forma especial en Qt Widgets Designer. Normalmente, al añadir páginas (pestañas, páginas, compartimentos) a estos contenedores en tu propio código, debes proporcionar widgets existentes, ya sea como marcadores de posición o como contenedores de widgets secundarios. En Qt Widgets Designer, estos se crean automáticamente, por lo que puedes añadir objetos hijos a cada página de inmediato.

Cada contenedor suele permitir que sus objetos hijos se organicen en uno o varios diseños. El tipo de gestión de diseños que ofrece depende de cada contenedor, aunque, por lo general, para configurar el diseño basta con seleccionar el contenedor haciendo clic en él y aplicar un diseño. La tabla siguiente muestra una lista de los contenedores disponibles.

Captura de pantalla en la que se muestra un fotograma seleccionadoMarcos

Los marcos se utilizan para enmarcar y agrupar widgets, así como para proporcionar decoración. Se emplean como base para contenedores más complejos, pero también pueden utilizarse como marcadores de posición en formularios.

Las propiedades más importantes de los marcos son ` frameShape`, ` frameShadow`, ` lineWidth` y ` midLineWidth`. Estas se describen con más detalle en la descripción de la clase ` QFrame `.

Captura de pantalla en la que se muestra un cuadro de grupo, que incluye varios widgets, que está seleccionadoCuadros de grupo

Los cuadros de grupo se suelen utilizar para agrupar conjuntos de casillas de selección y botones de opción con fines similares.

Entre las propiedades más importantes de los cuadros de grupo se encuentran title, flat, checkable y checked, tal y como se describe en la documentación de la clase QGroupBox. Cada cuadro de grupo puede contener su propio diseño, lo cual es necesario si contiene otros widgets. Para añadir un diseño al cuadro de grupo, haz clic en su interior y aplica el diseño como de costumbre.

Captura de pantalla en la que se muestra un cuadro de grupo que contiene elementos apilados unos sobre otrosWidgets apilados

Los widgets apilados son conjuntos de widgets en los que solo es visible la capa superior. El control sobre la capa visible suele gestionarse mediante otro widget, como un cuadro combinado, utilizando señales y ranuras.

Qt Widgets Designer Muestra unas flechas en la esquina superior derecha de la pila para permitirte ver todos los widgets de la pila al diseñarla. Estas flechas no aparecen en la vista previa ni en el componente final. Para navegar entre las páginas de la pila, selecciona el widget apilado y utiliza las entradas «Página siguiente» y «Página anterior» del menú contextual. Las opciones del menú contextual «Insertar página » y «Eliminar página » permiten añadir y eliminar páginas.

Captura de pantalla en la que se muestra un widget de pestañas dentro de un contenedorWidgets de pestañas

Los widgets de pestañas permiten al desarrollador dividir el contenido de un widget en diferentes secciones etiquetadas, de las cuales solo se muestra una en cada momento. De forma predeterminada, el widget de pestañas contiene dos pestañas, que se pueden eliminar o renombrar según sea necesario. También puedes añadir pestañas adicionales.

Para eliminar una pestaña:

  • Haz clic en su etiqueta para convertirla en la pestaña activa.
  • Selecciona el widget de pestañas y abre su menú contextual.
  • Selecciona «Eliminar página».

Para añadir una nueva pestaña:

  • Selecciona el widget de pestaña y abre su menú contextual.
  • Selecciona «Insertar página».
  • Puedes añadir una página antes o después de la página actual. « Qt Widgets Designer » creará un nuevo widget para esa pestaña en concreto y lo insertará en el widget de pestañas.
  • Puedes configurar el título de la pestaña actual modificando la propiedad « currentTabText » en el Editor de propiedades.
Captura de pantalla en la que se ve una caja de herramientas dentro de un contenedorWidgets de caja de herramientas

Los widgets de caja de herramientas proporcionan una serie de páginas o compartimentos en una caja de herramientas. Se gestionan de forma similar a los widgets apilados.

Para cambiar el nombre de una página de una caja de herramientas, establece la caja de herramientas como página actual y modifica su propiedad « currentItemText » desde el Editor de propiedades.

Para añadir una nueva página, selecciona «Insertar página » en el menú contextual del widget de caja de herramientas. Puedes añadir la página antes o después de la página actual.

Para eliminar una página, selecciona «Eliminar página » en el menú contextual del widget de la caja de herramientas.

Captura de pantalla en la que se ve un widget del dock dentro de un contenedorWidgets acoplados

Los widgets acoplados son paneles flotantes, que suelen contener widgets de entrada y controles más complejos, y que pueden acoplarse a los bordes de la ventana principal en «áreas de acoplamiento» o flotar como ventanas de herramientas independientes.

Aunque los widgets acoplados se pueden añadir a cualquier tipo de formulario, suelen utilizarse con formularios creados a partir de la plantilla de la ventana principal.

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