En esta página

QDesignerFormWindowManagerInterface Class

La clase QDesignerFormWindowManagerInterface le permite manipular la colección de ventanas de formulario en Qt Widgets Designer, y controlar las acciones de edición de formulario de Qt Widgets Designer. Más...

Cabecera: #include <QDesignerFormWindowManagerInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer
Hereda: 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 esta pensado para ser instanciado directamente. Qt Widgets Designer utiliza el gestor de ventanas de formulario para controlar las diferentes ventanas de formulario en su espacio de trabajo. Puede recuperar una interfaz para Qt Widgets Designer's form window manager usando 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 subclasificar QDesignerCustomWidgetInterface para exponer tu plugin a Qt Widgets Designer.

La interfaz del gestor de ventanas de formulario proporciona la función createFormWindow() que te permite crear una nueva ventana de formulario que puedes añadir a la colección de ventanas de formulario que el gestor mantiene, utilizando la ranura addFormWindow(). También proporciona la función formWindowCount() que devuelve el número de ventanas de formulario actualmente bajo el control del gestor, la función formWindow() que devuelve la ventana de formulario asociada a un índice dado, y la función activeFormWindow() que devuelve la ventana de formulario actualmente seleccionada. La ranura removeFormWindow() permite reducir el número de ventanas de formulario que debe mantener el gestor, 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 una colección 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, por lo que es posible propagar la función después de 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 actualmente seleccionada 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 de tipos de miembros

enum QDesignerFormWindowManagerInterface::Action

Especifica una acción de Qt Widgets Designer.

ConstanteValorDescripción
QDesignerFormWindowManagerInterface::CutAction100Cortar Portapapeles
QDesignerFormWindowManagerInterface::CopyAction101Copiar portapapeles
QDesignerFormWindowManagerInterface::PasteAction102Portapapeles Pegar
QDesignerFormWindowManagerInterface::DeleteAction103Borrar portapapeles
QDesignerFormWindowManagerInterface::SelectAllAction104Seleccionar todo
QDesignerFormWindowManagerInterface::LowerAction200Bajar el widget actual
QDesignerFormWindowManagerInterface::RaiseAction201Subir el widget actual
QDesignerFormWindowManagerInterface::UndoAction300Deshacer
QDesignerFormWindowManagerInterface::RedoAction301Rehacer
QDesignerFormWindowManagerInterface::HorizontalLayoutAction400Distribuir usando QHBoxLayout
QDesignerFormWindowManagerInterface::VerticalLayoutAction401Distribuir usando QVBoxLayout
QDesignerFormWindowManagerInterface::SplitHorizontalAction402Distribuir en horizontal QSplitter
QDesignerFormWindowManagerInterface::SplitVerticalAction403Distribuir en vertical QSplitter
QDesignerFormWindowManagerInterface::GridLayoutAction404Distribuir utilizando QGridLayout
QDesignerFormWindowManagerInterface::FormLayoutAction405Distribuir utilizando QFormLayout
QDesignerFormWindowManagerInterface::BreakLayoutAction406Romper la maquetación existente
QDesignerFormWindowManagerInterface::AdjustSizeAction407Ajustar tamaño
QDesignerFormWindowManagerInterface::SimplifyLayoutAction408Simplificar QGridLayout o QFormLayout
QDesignerFormWindowManagerInterface::DefaultPreviewAction500Crear una vista previa con el estilo predeterminado
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction600Mostrar 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.

ConstanteValorDescripción
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup100Grupo de acciones que contiene acciones de vista previa con estilo

Véase también actionGroup().

Documentación de la función miembro

[explicit] QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)

Construye una interfaz con la dirección parent para el gestor de ventanas del formulario.

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

Olvida 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 de 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 de formulario actualmente activa en el espacio de trabajo de Qt Widgets Designer. Se pasa como argumento un puntero al formWindow activo en ese momento.

Véase también activeFormWindow().

[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)

Añade el formWindow dado a la colección de ventanas que mantiene el gestor de ventanas de formularios de Qt Widgets Designer.

Ver también formWindowAdded().

[pure virtual slot] void QDesignerFormWindowManagerInterface::closeAllPreviews()

Cierra todas las vistas previas actualmente abiertas.

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 la dirección parent y la ventana flags.

Véase también addFormWindow().

[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const

Crea un mapa de píxeles que representa la vista previa del formulario activo en ese momento.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const

Devuelve la ventana del formulario en la dirección index.

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 mantiene el gestor de ventanas de formulario de Qt Widgets Designer. Se pasa como argumento un puntero a la nueva formWindow.

Véase también addFormWindow() y setActiveFormWindow().

[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const

Devuelve el número de ventanas de formulario mantenidas por el gestor de ventanas de formulario de Qt Widgets Designer.

[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)

Esta señal se emite cuando se elimina una ventana de formulario de la colección de ventanas que mantiene el gestor de ventanas de formulario de Qt Widgets Designer. Se pasa como argumento un puntero a la formWindow eliminada.

Véase también removeFormWindow().

[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)

Esta señal se emite cuando cambia la configuración de la ventana del formulario. Puede utilizarse para actualizar los títulos de las ventanas, etc., en consecuencia. Se pasa como argumento un puntero a formWindow.

Véase también FormWindowSettingsDialogAction.

[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)

Elimina el formWindow dado de la colección de ventanas que mantiene el gestor de ventanas de formulario de Qt Widgets Designer.

Véase también formWindow() y formWindowRemoved().

[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)

Establece formWindow como la ventana de formulario activa en el espacio de trabajo de Qt Widgets Designer.

Véase también activeFormWindow() y activeFormWindowChanged().

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPluginDialog()

Abre un diálogo que muestra los plugins cargados por Qt Widgets Designer's y sus fallos de carga de plugins.

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPreview()

Muestra una vista previa del formulario actual utilizando los parámetros por defecto.

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.