QDesignerFormWindowManagerInterface Class
La clase `QDesignerFormWindowManagerInterface` permite manipular la colección de ventanas de formulario en Qt Widgets Designer y controlar las acciones de edición de formularios de Qt Widgets Designer. Más información...
| Encabezado: | #include <QDesignerFormWindowManagerInterface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
| Heredan: | QObject |
Tipos públicos
| enum | Action { CutAction, CopyAction, PasteAction, DeleteAction, SelectAllAction, …, FormWindowSettingsDialogAction } |
| enum | ActionGroup { StyledPreviewActionGroup } |
Funciones públicas
| QDesignerFormWindowManagerInterface(QObject *parent = nullptr) | |
| virtual | ~QDesignerFormWindowManagerInterface() override |
| virtual QAction * | action(QDesignerFormWindowManagerInterface::Action action) const = 0 |
| virtual QActionGroup * | actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const = 0 |
| virtual QDesignerFormWindowInterface * | activeFormWindow() const = 0 |
| virtual QDesignerFormEditorInterface * | core() const = 0 |
| virtual QDesignerFormWindowInterface * | createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) = 0 |
| virtual QPixmap | createPreviewPixmap() const = 0 |
| virtual QDesignerFormWindowInterface * | formWindow(int index) const = 0 |
| virtual int | formWindowCount() const = 0 |
Ranuras públicas
| virtual void | addFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
| virtual void | closeAllPreviews() = 0 |
| virtual void | removeFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
| virtual void | setActiveFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
| virtual void | showPluginDialog() = 0 |
| virtual void | showPreview() = 0 |
Señales
| void | activeFormWindowChanged(QDesignerFormWindowInterface *formWindow) |
| void | formWindowAdded(QDesignerFormWindowInterface *formWindow) |
| void | formWindowRemoved(QDesignerFormWindowInterface *formWindow) |
| void | formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow) |
Descripción detallada
QDesignerFormWindowManagerInterface no está pensada para ser instanciada directamente. Qt Widgets Designer utiliza el gestor de ventanas de formularios para controlar las distintas ventanas de formularios de su espacio de trabajo. Puedes obtener una interfaz al gestor de ventanas de formularios de Qt Widgets Designer utilizando la función QDesignerFormEditorInterface::formWindowManager(). Por ejemplo:
auto *manager = formEditor->formWindowManager();
auto *formWindow = manager->formWindow(0);
manager->setActiveFormWindow(formWindow);Al implementar un complemento de widget personalizado, el parámetro de la función QDesignerCustomWidgetInterface::initialize() proporciona un puntero al objeto QDesignerFormEditorInterface actual de Qt Widgets Designer(formEditor en el ejemplo anterior). Debes crear una subclase de QDesignerCustomWidgetInterface para que tu complemento esté disponible en Qt Widgets Designer.
La interfaz del gestor de ventanas de formularios proporciona la función createFormWindow() que permite crear una nueva ventana de formulario que se puede añadir a la colección de ventanas de formularios que mantiene el gestor, utilizando la ranura addFormWindow(). También proporciona la función formWindowCount(), que devuelve el número de ventanas de formulario que se encuentran actualmente bajo el control del gestor; la función formWindow(), que devuelve la ventana de formulario asociada a un índice determinado; y la función activeFormWindow(), que devuelve la ventana de formulario seleccionada actualmente. La ranura « removeFormWindow()» permite reducir el número de ventanas de formulario que el gestor debe mantener, y la ranura « setActiveFormWindow()» permite cambiar el foco de la ventana de formulario en el espacio de trabajo de « Qt Widgets Designer ».
Además, `QDesignerFormWindowManagerInterface` contiene un conjunto de funciones que permiten intervenir y controlar las acciones de edición de formularios de ` Qt Widgets Designer`. Todas estas funciones devuelven la acción original, lo que permite que la función continúe ejecutándose tras la intervención.
Por último, la interfaz proporciona tres señales que se emiten cuando se añade una ventana de formulario, cuando cambia la ventana de formulario seleccionada actualmente o cuando se elimina una ventana de formulario, respectivamente. Todas las señales llevan como parámetro la ventana de formulario en cuestión.
Véase también QDesignerFormEditorInterface y QDesignerFormWindowInterface.
Documentación sobre tipos de miembros
enum QDesignerFormWindowManagerInterface::Action
Especifica una acción de Qt Widgets Designer.
| Constante | Valor | Descripción |
|---|---|---|
QDesignerFormWindowManagerInterface::CutAction | 100 | Portapapeles Cortar |
QDesignerFormWindowManagerInterface::CopyAction | 101 | Portapapeles: Cortar |
QDesignerFormWindowManagerInterface::PasteAction | 102 | Pegar del portapapeles |
QDesignerFormWindowManagerInterface::DeleteAction | 103 | Eliminar del portapapeles |
QDesignerFormWindowManagerInterface::SelectAllAction | 104 | Seleccionar todo |
QDesignerFormWindowManagerInterface::LowerAction | 200 | Bajar el widget actual |
QDesignerFormWindowManagerInterface::RaiseAction | 201 | Subir el widget actual |
QDesignerFormWindowManagerInterface::UndoAction | 300 | Deshacer |
QDesignerFormWindowManagerInterface::RedoAction | 301 | Rehacer |
QDesignerFormWindowManagerInterface::HorizontalLayoutAction | 400 | Diseñar utilizando QHBoxLayout |
QDesignerFormWindowManagerInterface::VerticalLayoutAction | 401 | Distribuir utilizando QVBoxLayout |
QDesignerFormWindowManagerInterface::SplitHorizontalAction | 402 | Distribuir en horizontal QSplitter |
QDesignerFormWindowManagerInterface::SplitVerticalAction | 403 | Distribuir en vertical QSplitter |
QDesignerFormWindowManagerInterface::GridLayoutAction | 404 | Distribuir utilizando QGridLayout |
QDesignerFormWindowManagerInterface::FormLayoutAction | 405 | Distribución mediante QFormLayout |
QDesignerFormWindowManagerInterface::BreakLayoutAction | 406 | Romper la disposición existente |
QDesignerFormWindowManagerInterface::AdjustSizeAction | 407 | Ajustar el tamaño |
QDesignerFormWindowManagerInterface::SimplifyLayoutAction | 408 | Simplificar « QGridLayout » o QFormLayout |
QDesignerFormWindowManagerInterface::DefaultPreviewAction | 500 | Crear una vista previa con el estilo predeterminado |
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction | 600 | Mostrar cuadro de diálogo con la configuración del formulario |
Véase también action().
enum QDesignerFormWindowManagerInterface::ActionGroup
Especifica un grupo de acciones de Qt Widgets Designer.
| Constante | Valor | Descripción |
|---|---|---|
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup | 100 | Grupo de acciones que contiene acciones de vista previa con estilo |
Véase también actionGroup().
Documentación de funciones de miembro
[explicit] QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)
Crea una interfaz con el ` parent ` indicado para el gestor de ventanas de formularios.
[override virtual noexcept] QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()
Destruye la interfaz del gestor de ventanas del formulario.
[pure virtual] QAction *QDesignerFormWindowManagerInterface::action(QDesignerFormWindowManagerInterface::Action action) const
Devuelve la acción especificada por el valor de enumeración action.
Deja obsoletos los accesores de acción de Qt 4.X.
[pure virtual] QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const
Devuelve el grupo de acciones especificado por el valor de enumeración « actionGroup ».
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const
Devuelve la ventana del formulario actualmente activa en el espacio de trabajo de Qt Widgets Designer.
Véase también setActiveFormWindow() y removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
Esta señal se emite cuando cambia el contenido de la ventana del formulario actualmente activa en el espacio de trabajo de Qt Widgets Designer. Se pasa como argumento un puntero al formWindow actualmente activo.
Véase también activeFormWindow().
[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)
Añade el formWindow especificado a la colección de ventanas que gestiona el gestor de ventanas de formularios de Qt Widgets Designer.
Véase también formWindowAdded().
[pure virtual slot] void QDesignerFormWindowManagerInterface::closeAllPreviews()
Cierra todas las vistas previas abiertas actualmente.
Véase también showPreview().
[pure virtual] QDesignerFormEditorInterface *QDesignerFormWindowManagerInterface::core() const
Devuelve un puntero al objeto ` QDesignerFormEditorInterface ` actual de ` Qt Widgets Designer`.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
Crea una ventana de formulario con el « parent » y el «window flags » indicados.
Véase también addFormWindow().
[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const
Crea un mapa de píxeles que representa la vista previa del formulario actualmente activo.
[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const
Devuelve la ventana del formulario en la dirección index indicada.
Véase también setActiveFormWindow() y removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)
Esta señal se emite cuando se añade una nueva ventana de formulario a la colección de ventanas que gestiona el gestor de ventanas de formularios de Qt Widgets Designer. Se pasa como argumento un puntero al nuevo formWindow.
Véanse también addFormWindow() y setActiveFormWindow().
[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const
Devuelve el número de ventanas de formulario gestionadas por el gestor de ventanas de formulario de Qt Widgets Designer.
[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)
Esta señal se emite cuando una ventana de formulario se elimina de la colección de ventanas que mantiene el gestor de ventanas de formularios de Qt Widgets Designer. Se pasa como argumento un puntero al objeto formWindow eliminado.
Véase también removeFormWindow().
[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)
Esta señal se emite cuando cambian los ajustes de la ventana del formulario. Se puede utilizar para actualizar los títulos de las ventanas, etc., en consecuencia. Se pasa como argumento un puntero al objeto ` formWindow `.
Véase también FormWindowSettingsDialogAction.
[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)
Elimina el formWindow especificado de la colección de ventanas que gestiona el gestor de ventanas de formularios de Qt Widgets Designer.
Véase también formWindow() y formWindowRemoved().
[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)
Establece el objeto ` formWindow ` indicado como la ventana de formulario activa actualmente en el espacio de trabajo de ` Qt Widgets Designer`.
Véase también activeFormWindow() y activeFormWindowChanged().
[pure virtual slot] void QDesignerFormWindowManagerInterface::showPluginDialog()
Abre un cuadro de diálogo en el que se muestran los complementos cargados por Qt Widgets Designer, así como los errores que se han producido al cargarlos.
[pure virtual slot] void QDesignerFormWindowManagerInterface::showPreview()
Mostrar una vista previa del formulario actual utilizando los parámetros predeterminados.
Véase también closeAllPreviews().
© 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.