QFormBuilder Class
La clase QFormBuilder se utiliza para crear dinámicamente interfaces de usuario a partir de archivos de interfaz de usuario en tiempo de ejecución. Más información...
| Encabezado: | #include <QFormBuilder> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake: | QT += designer |
| Heredado de: | QAbstractFormBuilder |
Funciones públicas
| QFormBuilder() | |
| virtual | ~QFormBuilder() override |
| void | addPluginPath(const QString &pluginPath) |
| void | clearPluginPaths() |
| QList<QDesignerCustomWidgetInterface *> | customWidgets() const |
| QStringList | pluginPaths() const |
| void | setPluginPath(const QStringList &pluginPaths) |
Descripción detallada
La clase QFormBuilder proporciona un mecanismo para crear dinámicamente interfaces de usuario en tiempo de ejecución, basándose en archivos de interfaz de usuario creados con Qt Widgets Designer. Por ejemplo:
MyForm::MyForm(QWidget *parent)
: QWidget(parent)
{
QFormBuilder builder;
QFile file(":/forms/myWidget.ui");
file.open(QFile::ReadOnly);
QWidget *myWidget = builder.load(&file, this);
file.close();
auto *layout = new QVBoxLayout(this);
layout->addWidget(myWidget);
}Al incluir la interfaz de usuario en los recursos del ejemplo (myForm.qrc), nos aseguramos de que esté presente cuando se ejecute el ejemplo:
<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/forms">
<file>mywidget.ui</file>
</qresource>
</RCC>QFormBuilder amplía la clase base QAbstractFormBuilder con una serie de funciones que se utilizan para dar soporte a complementos de widgets personalizados:
- pluginPaths() devuelve la lista de rutas en las que el generador de formularios busca al cargar complementos de widgets personalizados.
- addPluginPath() permite registrar rutas adicionales en el generador de formularios.
- setPluginPath() se utiliza para sustituir la lista de rutas existente por una lista obtenida de otra fuente.
- clearPluginPaths() elimina todas las rutas registradas en el generador de formularios.
- customWidgets() devuelve una lista de interfaces para complementos que pueden utilizarse para crear nuevas instancias de widgets personalizados registrados.
La clase `QFormBuilder` suele ser utilizada por componentes personalizados y aplicaciones que integran ` Qt Widgets Designer`. Las aplicaciones independientes que necesitan generar dinámicamente interfaces de usuario en tiempo de ejecución utilizan la clase ` QUiLoader `, que se encuentra en el módulo ` QtUiTools `.
Véase también QAbstractFormBuilder y Qt UI Tools.
Documentación de las funciones de miembro
QFormBuilder::QFormBuilder()
Crea un nuevo generador de formularios.
[override virtual noexcept] QFormBuilder::~QFormBuilder()
Elimina el generador de formularios.
void QFormBuilder::addPluginPath(const QString &pluginPath)
Añade una nueva ruta de complementos, especificada en pluginPath, a la lista de rutas que el generador de formularios buscará al cargar un complemento de widget personalizado.
Véase también setPluginPath() y clearPluginPaths().
void QFormBuilder::clearPluginPaths()
Borra la lista de rutas que utiliza el generador de formularios para buscar complementos de widgets personalizados.
Véase también pluginPaths().
QList<QDesignerCustomWidgetInterface *> QFormBuilder::customWidgets() const
Devuelve una lista de los complementos disponibles.
QStringList QFormBuilder::pluginPaths() const
Devuelve la lista de rutas en las que el generador de formularios busca los complementos.
Véase también addPluginPath().
void QFormBuilder::setPluginPath(const QStringList &pluginPaths)
Establece la lista de rutas de los complementos según la especificada en pluginPaths.
Véase también addPluginPath().
© 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.