QMdiSubWindow Class
La clase QMdiSubWindow proporciona una clase de subventana para QMdiArea. Más información...
| Encabezado: | #include <QMdiSubWindow> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QWidget |
Tipos públicos
| enum | SubWindowOption { RubberBandResize, RubberBandMove } |
| flags | SubWindowOptions |
Propiedades
- keyboardPageStep : int
- keyboardSingleStep : int
Funciones públicas
| QMdiSubWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) | |
| virtual | ~QMdiSubWindow() |
| bool | isShaded() const |
| int | keyboardPageStep() const |
| int | keyboardSingleStep() const |
| QMdiArea * | mdiArea() const |
| void | setKeyboardPageStep(int step) |
| void | setKeyboardSingleStep(int step) |
| void | setOption(QMdiSubWindow::SubWindowOption option, bool on = true) |
| void | setSystemMenu(QMenu *systemMenu) |
| void | setWidget(QWidget *widget) |
| QMenu * | systemMenu() const |
| bool | testOption(QMdiSubWindow::SubWindowOption option) const |
| QWidget * | widget() const |
Funciones públicas reimplementadas
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Ranuras públicas
| void | showShaded() |
| void | showSystemMenu() |
Señales
| void | aboutToActivate() |
| void | windowStateChanged(Qt::WindowStates oldState, Qt::WindowStates newState) |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *changeEvent) override |
| virtual void | childEvent(QChildEvent *childEvent) override |
| virtual void | closeEvent(QCloseEvent *closeEvent) override |
| virtual void | contextMenuEvent(QContextMenuEvent *contextMenuEvent) override |
| virtual bool | event(QEvent *event) override |
| virtual bool | eventFilter(QObject *object, QEvent *event) override |
| virtual void | focusInEvent(QFocusEvent *focusInEvent) override |
| virtual void | focusOutEvent(QFocusEvent *focusOutEvent) override |
| virtual void | hideEvent(QHideEvent *hideEvent) override |
| virtual void | keyPressEvent(QKeyEvent *keyEvent) override |
| virtual void | leaveEvent(QEvent *leaveEvent) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *mouseEvent) override |
| virtual void | mouseMoveEvent(QMouseEvent *mouseEvent) override |
| virtual void | mousePressEvent(QMouseEvent *mouseEvent) override |
| virtual void | mouseReleaseEvent(QMouseEvent *mouseEvent) override |
| virtual void | moveEvent(QMoveEvent *moveEvent) override |
| virtual void | paintEvent(QPaintEvent *paintEvent) override |
| virtual void | resizeEvent(QResizeEvent *resizeEvent) override |
| virtual void | showEvent(QShowEvent *showEvent) override |
| virtual void | timerEvent(QTimerEvent *timerEvent) override |
Descripción detallada
QMdiSubWindow representa una ventana de nivel superior en un ` QMdiArea` y consta de una barra de título con decoraciones de ventana, un widget interno y (dependiendo del estilo actual) un marco de ventana y un control de tamaño. QMdiSubWindow tiene su propio diseño, que consta de la barra de título y un área central para el widget interno.

La forma más habitual de crear una QMdiSubWindow es llamar a ` QMdiArea::addSubWindow()` con el widget interno como argumento. También puedes crear una subventana tú mismo y establecer un widget interno llamando a ` setWidget()`.
Al programar con subventanas se utiliza la misma API que con las ventanas normales de nivel superior (por ejemplo, se pueden llamar funciones como show(), hide(), showMaximized() y setWindowTitle()).
Gestión de subventanas
QMdiSubWindow también admite comportamientos específicos de las subventanas en un área MDI.
Por defecto, cada QMdiSubWindow es visible dentro del área de visualización del área MDI cuando se desplaza, pero también es posible especificar un comportamiento transparente para el movimiento y el redimensionamiento de la ventana, de modo que solo se actualice el contorno de la subventana durante estas operaciones. La función setOption() se utiliza para habilitar este comportamiento.
La función ` isShaded()` detecta si la subventana se encuentra actualmente en modo sombreado (es decir, la ventana está colapsada de modo que solo es visible la barra de título). Para entrar en modo sombreado, se llama a ` showShaded()`. QMdiSubWindow emite la señal « windowStateChanged()» cada vez que cambia el estado de la ventana (por ejemplo, cuando la ventana se minimiza o se restaura). También emite « aboutToActivate()» antes de activarse.
En el modo interactivo con el teclado, las ventanas se mueven y se redimensionan mediante el teclado. Se puede acceder a este modo a través del menú de sistema de la ventana. Las propiedades keyboardSingleStep y keyboardPageStep controlan la distancia a la que se desplaza o redimensiona el widget por cada pulsación de tecla. Cuando se mantiene pulsada la tecla Mayús, se utiliza el avance por página; en caso contrario, se utiliza el avance por paso.
También puedes cambiar la ventana activa con el teclado. Al pulsar las teclas Control y Tab a la vez, se activará la subventana siguiente (según el valor actual de ` WindowOrder`). Al pulsar Control, Mayús y Tab, se activará la ventana anterior. Esto equivale a llamar a ` activateNextSubWindow()` y ` activatePreviousSubWindow()`. Ten en cuenta que estos atajos anulan los atajos globales, pero no los de QMdiArea.
Véase también QMdiArea.
Documentación sobre tipos de miembros
enum QMdiSubWindow::SubWindowOption
flags QMdiSubWindow::SubWindowOptions
Esta enumeración describe las opciones que permiten personalizar el comportamiento de QMdiSubWindow.
| Constante | Valor | Descripción |
|---|---|---|
QMdiSubWindow::RubberBandResize | 0x4 | Si se habilita esta opción, se utiliza un control de «banda elástica» para representar el contorno de la subventana, y el usuario cambia el tamaño de este en lugar de hacerlo con la propia subventana. Como resultado, la subventana mantiene su posición y tamaño originales hasta que se haya completado la operación de cambio de tamaño, momento en el que recibirá un único evento ` QResizeEvent`. De forma predeterminada, esta opción está deshabilitada. |
QMdiSubWindow::RubberBandMove | 0x8 | Si se habilita esta opción, se utiliza un control de «banda elástica» para representar el contorno de la subventana, y el usuario mueve este en lugar de la propia subventana. Como resultado, la subventana permanece en su posición original hasta que se haya completado la operación de desplazamiento, momento en el que se envía un ` QMoveEvent ` a la ventana. Por defecto, esta opción está deshabilitada. |
El tipo `SubWindowOptions` es una definición de tipo (`typedef`) para ` QFlags<SubWindowOption>`. Almacena una combinación OR de valores de `SubWindowOption`.
Documentación de la propiedad
keyboardPageStep : int
Establece la distancia a la que debe desplazarse o cambiar de tamaño un widget al utilizar las teclas de página del teclado.
En el modo interactivo del teclado, puedes utilizar las teclas de flecha y de navegación por páginas para mover o cambiar el tamaño de la ventana. Esta propiedad controla las teclas de navegación por páginas. La forma habitual de acceder al modo interactivo del teclado es entrar en el menú de la subventana y seleccionar «cambiar tamaño» o «mover».
El valor predeterminado del paso de las teclas de página del teclado es de 20 píxeles.
Funciones de acceso:
| int | keyboardPageStep() const |
| void | setKeyboardPageStep(int step) |
Véase también keyboardSingleStep.
keyboardSingleStep : int
Establece la distancia a la que debe desplazarse o cambiar de tamaño un widget al utilizar las teclas de flecha del teclado.
En el modo interactivo del teclado, puedes utilizar las teclas de flecha y de navegación por páginas para desplazar o cambiar el tamaño de la ventana. Esta propiedad controla las teclas de flecha. La forma habitual de acceder al modo interactivo del teclado es entrar en el menú de la subventana y seleccionar «cambiar tamaño» o «desplazar».
El valor predeterminado del paso único del teclado es de 5 píxeles.
Funciones de acceso:
| int | keyboardSingleStep() const |
| void | setKeyboardSingleStep(int step) |
Véase también keyboardPageStep.
Documentación de funciones de miembro
QMdiSubWindow::QMdiSubWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Crea un nuevo widget QMdiSubWindow. Los argumentos « parent » y « flags » se pasan al constructor de « QWidget ».
En lugar de utilizar addSubWindow(), también es posible utilizar simplemente setParent() al añadir la subventana a una QMdiArea.
Ten en cuenta que solo los QMdiSubWindowpueden establecerse como hijos de un QMdiArea; no puedes, por ejemplo, escribir:
Véase también ` QMdiArea::addSubWindow()`.
[virtual noexcept] QMdiSubWindow::~QMdiSubWindow()
Elimina la subventana.
Véase también QMdiArea::removeSubWindow().
[signal] void QMdiSubWindow::aboutToActivate()
QMdiSubWindow emite esta señal justo antes de que se active. Una vez activada la subventana, el objeto « QMdiArea » que la gestiona también emitirá la señal « subWindowActivated()».
Véase también QMdiArea::subWindowActivated().
[override virtual protected] void QMdiSubWindow::changeEvent(QEvent *changeEvent)
Reimplementa: ` QWidget::changeEvent(QEvent *event)`.
[override virtual protected] void QMdiSubWindow::childEvent(QChildEvent *childEvent)
Reimplementa: ` QObject::childEvent(QChildEvent *event)`.
[override virtual protected] void QMdiSubWindow::closeEvent(QCloseEvent *closeEvent)
Reimplementa: QWidget::closeEvent(QCloseEvent *event).
[override virtual protected] void QMdiSubWindow::contextMenuEvent(QContextMenuEvent *contextMenuEvent)
Reimplementa: QWidget::contextMenuEvent(QContextMenuEvent *event).
[override virtual protected] bool QMdiSubWindow::event(QEvent *event)
Reimplementa: ` QWidget::event(QEvent *event)`.
[override virtual protected] bool QMdiSubWindow::eventFilter(QObject *object, QEvent *event)
Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).
[override virtual protected] void QMdiSubWindow::focusInEvent(QFocusEvent *focusInEvent)
Reimplementa: QWidget::focusInEvent(QFocusEvent *event).
[override virtual protected] void QMdiSubWindow::focusOutEvent(QFocusEvent *focusOutEvent)
Reimplementa: QWidget::focusOutEvent(QFocusEvent *event).
[override virtual protected] void QMdiSubWindow::hideEvent(QHideEvent *hideEvent)
Reimplementa: QWidget::hideEvent(QHideEvent *event).
bool QMdiSubWindow::isShaded() const
Devuelve ` true ` si esta ventana está minimizada; en caso contrario, devuelve ` false`.
Una ventana está minimizada si se ha colapsado de tal forma que solo se ve la barra de título.
[override virtual protected] void QMdiSubWindow::keyPressEvent(QKeyEvent *keyEvent)
Reimplementa: ` QWidget::keyPressEvent(QKeyEvent *event)`.
[override virtual protected] void QMdiSubWindow::leaveEvent(QEvent *leaveEvent)
Reimplementa: ` QWidget::leaveEvent(QEvent *event)`.
QMdiArea *QMdiSubWindow::mdiArea() const
Devuelve el área que contiene esta subventana, o ` nullptr ` si no hay ninguna.
Véase también QMdiArea::addSubWindow().
[override virtual] QSize QMdiSubWindow::minimumSizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.
[override virtual protected] void QMdiSubWindow::mouseDoubleClickEvent(QMouseEvent *mouseEvent)
Reimplementa: QWidget::mouseDoubleClickEvent(QMouseEvent *event).
[override virtual protected] void QMdiSubWindow::mouseMoveEvent(QMouseEvent *mouseEvent)
Reimplementa: ` QWidget::mouseMoveEvent(QMouseEvent *event)`.
[override virtual protected] void QMdiSubWindow::mousePressEvent(QMouseEvent *mouseEvent)
Reimplementa: QWidget::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QMdiSubWindow::mouseReleaseEvent(QMouseEvent *mouseEvent)
Reimplementa: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.
[override virtual protected] void QMdiSubWindow::moveEvent(QMoveEvent *moveEvent)
Reimplementa: QWidget::moveEvent(QMoveEvent *event).
[override virtual protected] void QMdiSubWindow::paintEvent(QPaintEvent *paintEvent)
Reimplementa: QWidget::paintEvent(QPaintEvent *event).
[override virtual protected] void QMdiSubWindow::resizeEvent(QResizeEvent *resizeEvent)
Reimplementa: ` QWidget::resizeEvent(QResizeEvent *event)`.
Advertencia: Al maximizar o restaurar una subventana, la llamada resultante a esta función puede tener un QResizeEvent::oldSize() no válido.
void QMdiSubWindow::setOption(QMdiSubWindow::SubWindowOption option, bool on = true)
Si « on » es verdadero, « option » está activado en la subventana; en caso contrario, está desactivado. Consulta SubWindowOption para conocer el efecto de cada opción.
Véanse también SubWindowOption y testOption().
void QMdiSubWindow::setSystemMenu(QMenu *systemMenu)
Establece systemMenu como el menú del sistema actual para esta subventana.
Por defecto, cada QMdiSubWindow tiene un menú del sistema estándar.
Las QActions del menú del sistema creado por QMdiSubWindow se actualizarán automáticamente en función del estado actual de la ventana; por ejemplo, la acción de minimizar se desactivará una vez que la ventana se haya minimizado.
Las QActions añadidas por el usuario no son actualizadas por « QMdiSubWindow ».
QMdiSubWindow systemMenu asume la propiedad; no es necesario eliminarlo. Se eliminarán todos los menús existentes.
Véase también systemMenu() y showSystemMenu().
void QMdiSubWindow::setWidget(QWidget *widget)
Establece widget como el widget interno de esta subventana. El widget interno se muestra en el centro de la subventana, debajo de la barra de título.
QMdiSubWindow Asume temporalmente la propiedad de widget; no es necesario eliminarlo. Cualquier widget interno existente se eliminará y se volverán a vincular a la ventana raíz.
Véase también widget().
[override virtual protected] void QMdiSubWindow::showEvent(QShowEvent *showEvent)
Reimplementa: ` QWidget::showEvent(QShowEvent *event)`.
[slot] void QMdiSubWindow::showShaded()
Al llamar a esta función, la subventana pasa al modo sombreado. Cuando la subventana está sombreada, solo se ve la barra de título.
Aunque no todos los estilos admiten el modo sombreado, esta función mostrará la subventana como sombreada, independientemente de si dicho modo está disponible. Sin embargo, cuando se utilice con estilos que no admitan el modo sombreado, el usuario no podrá salir del modo sombreado a través de la interfaz de usuario (por ejemplo, mediante un botón de sombreado en la barra de título).
Véase también isShaded().
[slot] void QMdiSubWindow::showSystemMenu()
Muestra el menú del sistema debajo del icono del menú del sistema en la barra de título.
Véase también setSystemMenu() y systemMenu().
[override virtual] QSize QMdiSubWindow::sizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.
QMenu *QMdiSubWindow::systemMenu() const
Devuelve un puntero al menú del sistema actual, o cero si no hay ningún menú del sistema configurado. QMdiSubWindow proporciona un menú del sistema por defecto, pero también puedes configurar el menú con setSystemMenu().
Véase también setSystemMenu() y showSystemMenu().
bool QMdiSubWindow::testOption(QMdiSubWindow::SubWindowOption option) const
Devuelve « true » si « option » está habilitado; en caso contrario, devuelve « false ».
Véase también ` SubWindowOption ` y ` setOption()`.
[override virtual protected] void QMdiSubWindow::timerEvent(QTimerEvent *timerEvent)
Reimplementa: ` QObject::timerEvent(QTimerEvent *event)`.
QWidget *QMdiSubWindow::widget() const
Devuelve el widget interno actual.
Véase también ` setWidget()`.
[signal] void QMdiSubWindow::windowStateChanged(Qt::WindowStates oldState, Qt::WindowStates newState)
QMdiSubWindow emite esta señal cuando cambia el estado de la ventana. oldState es el estado de la ventana antes del cambio, y newState es el nuevo estado actual.
© 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.