Widgets de ventana y cuadro de diálogo
Un widget que no está incrustado en un widget padre se denomina ventana. Normalmente, las ventanas tienen un marco y una barra de título, aunque también es posible crear ventanas sin dicha decoración utilizando los indicadores de ventana adecuados. En Qt, ` QMainWindow ` y las diversas subclases de ` QDialog ` son los tipos de ventana más comunes.
En las aplicaciones, las ventanas proporcionan el espacio en pantalla sobre el que se construye la interfaz de usuario. Las ventanas separan visualmente unas aplicaciones de otras y, por lo general, ofrecen una decoración que permite cambiar el tamaño y la posición de las aplicaciones según las preferencias del usuario. Las ventanas suelen estar integradas en el entorno de escritorio y, en cierta medida, son gestionadas por el sistema de gestión de ventanas que proporciona dicho entorno. Por ejemplo, las ventanas seleccionadas de una aplicación se muestran en la barra de tareas.
Ventanas principales y secundarias
Cualquier objeto ` QWidget ` que no tenga un padre se convertirá en una ventana y, en la mayoría de las plataformas, aparecerá en la barra de tareas del escritorio. Normalmente, esto solo se desea para una ventana de la aplicación: la ventana principal.
Además, un objeto « QWidget » que tenga una ventana principal puede convertirse en una ventana activando el indicador « Qt::Window ». Dependiendo del sistema de gestión de ventanas, estas ventanas secundarias suelen apilarse sobre su respectiva ventana principal y no tienen una entrada propia en la barra de tareas.
La clase « QMainWindow » establece el indicador « Qt::Window » en su constructor, ya que está diseñada para utilizarse como ventana y proporciona funciones que no son necesarias para los widgets secundarios.
Ventanas principales y cuadros de diálogo
La ventana principal de la aplicación proporciona el marco para crear la interfaz de usuario principal de la aplicación y se crea mediante la subclasificación de ` QMainWindow`. ` QMainWindow ` tiene su propio diseño, al que se pueden añadir un ` menu bar`, un ` tool bars`, un ` dockable widgets ` y un ` status bar`. El área central puede estar ocupada por cualquier tipo de ` QWidget`.
Las ventanas de diálogo se utilizan como ventanas secundarias que te presentan opciones y alternativas. Los diálogos se crean subclasificando QDialog y utilizando widgets y diseños para implementar la interfaz de usuario. Además, Qt proporciona una serie de diálogos estándar ya preparados que pueden utilizarse para tareas habituales, como la selección de archivos o de fuentes.
Tanto las ventanas principales como los cuadros de diálogo se pueden crear con Qt Widgets Designer, la herramienta de diseño visual de Qt. Utilizar Qt Widgets Designer es mucho más rápido que programar a mano y facilita la prueba de diferentes ideas de diseño. ¡Crear diseños de forma visual y leer el código generado por uic es una forma estupenda de aprender Qt!
Geometría de la ventana
QWidget ofrece varias funciones que gestionan la geometría de un widget. Algunas de estas funciones operan sobre el área de cliente pura (es decir, la ventana sin el marco), mientras que otras incluyen el marco de la ventana. QWidget distingue entre ambos casos de una forma que cubre los usos más comunes de manera transparente.
- Incluyendo el marco de la ventana: x(), y(), frameGeometry(), pos() y move().
- Sin incluir el marco de la ventana: geometry(), width(), height(), rect() y size().
Ten en cuenta que esta distinción solo es relevante para los widgets decorados de nivel superior. Para todos los widgets hijos, la geometría del marco es igual a la geometría del cliente del widget.
Este diagrama muestra la mayoría de las funciones que se utilizan:
Peculiaridades de X11
En X11, una ventana no tiene marco hasta que el gestor de ventanas la decora. Esto ocurre de forma asíncrona en algún momento después de llamar a ` QWidget::show()` y del primer evento de dibujo que recibe la ventana, o no ocurre en absoluto. Ten en cuenta que X11 carece de normas fijas (otros lo llaman «flexible»). Por lo tanto, no puedes hacer ninguna suposición segura sobre el marco de decoración que tendrá tu ventana. Regla básica: siempre hay un usuario que utiliza un gestor de ventanas que contradice tu suposición y que se quejará a ti.
Además, un kit de herramientas no puede limitarse a colocar ventanas en la pantalla. Lo único que puede hacer Qt es enviar ciertas indicaciones al gestor de ventanas. El gestor de ventanas, que es un proceso independiente, puede obedecerlas, ignorarlas o malinterpretarlas. Debido a que el Manual de Convenciones de Comunicación entre Clientes (ICCCM) es en parte poco claro, la colocación de ventanas se gestiona de forma diferente en los distintos gestores de ventanas existentes.
X11 no ofrece ninguna forma estándar o sencilla de obtener la geometría del marco una vez que la ventana está decorada. Qt resuelve este problema con ingeniosas heurísticas y un código inteligente que funciona en una amplia gama de gestores de ventanas existentes en la actualidad. No te sorprendas, sin embargo, si encuentras alguno en el que QWidget::frameGeometry() devuelva resultados erróneos.
X11 tampoco proporciona una forma de maximizar una ventana. La función ` QWidget::showMaximized()` tiene que emular esta característica. Su resultado depende del resultado de ` QWidget::frameGeometry()` y de la capacidad del gestor de ventanas para colocar correctamente la ventana, y ninguno de estos dos factores puede garantizarse.
Peculiaridades de Wayland
En Wayland, normalmente no se admite establecer u obtener mediante programación la posición de una ventana de nivel superior desde el lado del cliente. Técnicamente hablando, depende de la interfaz del shell. Sin embargo, para los compositores de escritorio habituales, la interfaz de shell por defecto será XDG Shell, que no admite el posicionamiento manual de ventanas. En tales casos, Qt ignorará las llamadas para establecer la posición de nivel superior de una ventana y, cuando se consulte, la posición de la ventana siempre se devolverá como QPoint(0, 0).
© 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.