En esta página

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.

ConstanteValorDescripción
QDesignerFormWindowManagerInterface::CutAction100Portapapeles Cortar
QDesignerFormWindowManagerInterface::CopyAction101Portapapeles: Cortar
QDesignerFormWindowManagerInterface::PasteAction102Pegar del portapapeles
QDesignerFormWindowManagerInterface::DeleteAction103Eliminar del portapapeles
QDesignerFormWindowManagerInterface::SelectAllAction104Seleccionar todo
QDesignerFormWindowManagerInterface::LowerAction200Bajar el widget actual
QDesignerFormWindowManagerInterface::RaiseAction201Subir el widget actual
QDesignerFormWindowManagerInterface::UndoAction300Deshacer
QDesignerFormWindowManagerInterface::RedoAction301Rehacer
QDesignerFormWindowManagerInterface::HorizontalLayoutAction400Diseñar utilizando QHBoxLayout
QDesignerFormWindowManagerInterface::VerticalLayoutAction401Distribuir utilizando QVBoxLayout
QDesignerFormWindowManagerInterface::SplitHorizontalAction402Distribuir en horizontal QSplitter
QDesignerFormWindowManagerInterface::SplitVerticalAction403Distribuir en vertical QSplitter
QDesignerFormWindowManagerInterface::GridLayoutAction404Distribuir utilizando QGridLayout
QDesignerFormWindowManagerInterface::FormLayoutAction405Distribución mediante QFormLayout
QDesignerFormWindowManagerInterface::BreakLayoutAction406Romper la disposición existente
QDesignerFormWindowManagerInterface::AdjustSizeAction407Ajustar el tamaño
QDesignerFormWindowManagerInterface::SimplifyLayoutAction408Simplificar « QGridLayout » o QFormLayout
QDesignerFormWindowManagerInterface::DefaultPreviewAction500Crear una vista previa con el estilo predeterminado
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction600Mostrar 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.

ConstanteValorDescripción
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup100Grupo 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.