QUiLoader Class
Carga e instanciar formularios de Qt Widgets Designer en tiempo de ejecución. Más...
| Encabezado: | #include <QUiLoader> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS UiTools) target_link_libraries(mytarget PRIVATE Qt6::UiTools) |
| qmake: | QT += uitools |
| Heredado de: | QObject |
Funciones públicas
| QUiLoader(QObject *parent = nullptr) | |
| virtual | ~QUiLoader() override |
| void | addPluginPath(const QString &path) |
| QStringList | availableLayouts() const |
| QStringList | availableWidgets() const |
| void | clearPluginPaths() |
| virtual QAction * | createAction(QObject *parent = nullptr, const QString &name = QString()) |
| virtual QActionGroup * | createActionGroup(QObject *parent = nullptr, const QString &name = QString()) |
| virtual QLayout * | createLayout(const QString &className, QObject *parent = nullptr, const QString &name = QString()) |
| virtual QWidget * | createWidget(const QString &className, QWidget *parent = nullptr, const QString &name = QString()) |
| QString | errorString() const |
| bool | isLanguageChangeEnabled() const |
| QWidget * | load(QIODevice *device, QWidget *parentWidget = nullptr) |
| QStringList | pluginPaths() const |
| void | setLanguageChangeEnabled(bool enabled) |
| void | setWorkingDirectory(const QDir &dir) |
| QDir | workingDirectory() const |
Descripción detallada
Utilice QUiLoader para crear dinámicamente interfaces de usuario basadas en QWidget, a partir de la información almacenada en los archivos de interfaz de usuario (creados con Qt Widgets Designer).
La función ` load()` lee el contenido de un archivo UI, crea instancias de los widgets descritos en el archivo y devuelve un puntero al ` QWidget` de nivel superior. A continuación, este widget se puede mostrar:
MyWidget::MyWidget(QWidget*parent)
: QWidget(parent)
{
QFile file(":/forms/myform.ui");
if (!file.open(QFile::ReadOnly))
qFatal("Cannot open resource file");
QUiLoader loader;
QWidget*myWidget = loader.load(&file, this);
QVBoxLayout*layout = new QVBoxLayout;
layout->addWidget(myWidget);
setLayout(layout);
}Si la instanciación falla, la función devuelve un ` nullptr`; utiliza la función ` errorString()` para obtener una descripción legible del error que se ha producido.
Carga de formularios con widgets personalizados
Si el archivo de interfaz de usuario contiene widgets personalizados implementados en un complemento de Qt Widgets Designer, la carga fallará por defecto. Para solucionar esto, puedes crear una subclase de QUiLoader y sobrescribir la función createWidget(). Si esto no es posible, también puedes hacer que el módulo cargue los complementos de Qt Widgets Designer añadiendo sus ubicaciones mediante addPluginPath() o la variable de entorno QT_PLUGIN_PATH. Consulta la página «Creación de widgets personalizados para Qt Widgets Designer » para obtener más detalles.
Carga de un widget concreto desde un archivo de interfaz de usuario
Puedes cargar un widget específico desde un archivo de interfaz de usuario, en lugar de un archivo de interfaz de usuario completo. Utiliza la función availableWidgets() para recuperar los nombres de los widgets disponibles y la función createWidget() para instanciar uno específico. Por ejemplo:
QWidget*loadCustomWidget(const QString&className, QWidget*parent)
{
QUiLoader loader;
QStringList availableWidgets = loader.availableWidgets();
if (!availableWidgets.contains(className)) {
qWarning() << "Cannot create widget" << className;
return nullptr;
}
return loader.createWidget(className, parent);
}Personalización de la creación del widget
Las funciones createAction(), createActionGroup(), createLayout() y createWidget() son utilizadas internamente por la clase QUiLoader cada vez que tiene que crear una acción, un grupo de acciones, un diseño o un widget, respectivamente. Puedes crear una subclase de QUiLoader y reimplementar estas funciones para personalizar el flujo de trabajo de creación de la interfaz de usuario. Por ejemplo, es posible que desees disponer de una lista de las acciones creadas al cargar un formulario o al crear un widget personalizado.
Ejemplo
Para ver un ejemplo completo del uso de la clase QUiLoader, consulta el «Calculator Builder».
Véase también Qt UI Tools y QFormBuilder.
Documentación de funciones de miembro
[explicit] QUiLoader::QUiLoader(QObject *parent = nullptr)
Crea un cargador de formularios con el parent especificado.
[override virtual noexcept] QUiLoader::~QUiLoader()
Destruye la cargadora.
void QUiLoader::addPluginPath(const QString &path)
Añade la ruta « path » a la lista de rutas en las que el cargador buscará al localizar los complementos.
Advertencia: Estableceúnicamente rutas en las que confíes. Permitir que usuarios no de confianza creen o añadan contenido en una ruta especificada puede dar lugar a vulnerabilidades de seguridad.
Véase también pluginPaths() y clearPluginPaths().
QStringList QUiLoader::availableLayouts() const
Devuelve una lista de todos los diseños disponibles que se pueden crear mediante la función createLayout().
Véase también ` createLayout()`.
QStringList QUiLoader::availableWidgets() const
Devuelve una lista de todos los widgets disponibles que se pueden crear mediante la función createWidget(), es decir, todos los widgets especificados en las rutas de los complementos indicadas.
Véase también pluginPaths() y createWidget().
void QUiLoader::clearPluginPaths()
Borra la lista de rutas en las que el cargador buscará al localizar los complementos.
Véase también addPluginPath() y pluginPaths().
[virtual] QAction *QUiLoader::createAction(QObject *parent = nullptr, const QString &name = QString())
Crea una nueva acción con los valores indicados para « parent » y « name ».
La clase ` QUiLoader ` también utiliza esta función internamente cada vez que crea una acción. Por lo tanto, puedes crear una subclase de ` QUiLoader ` y reimplementar esta función para intervenir en el proceso de construcción de una interfaz de usuario o un widget. Sin embargo, en tu implementación, asegúrate de llamar primero a la versión de ` QUiLoader`.
Véase también createActionGroup(), createWidget() y load().
[virtual] QActionGroup *QUiLoader::createActionGroup(QObject *parent = nullptr, const QString &name = QString())
Crea un nuevo grupo de acciones con los valores indicados para « parent » y « name ».
La clase ` QUiLoader ` también utiliza esta función internamente cada vez que crea un grupo de acciones. Por lo tanto, puedes crear una subclase de ` QUiLoader ` y reimplementar esta función para intervenir en el proceso de construcción de una interfaz de usuario o un widget. Sin embargo, en tu implementación, asegúrate de llamar primero a la versión de ` QUiLoader`.
Véase también createAction(), createWidget() y load().
[virtual] QLayout *QUiLoader::createLayout(const QString &className, QObject *parent = nullptr, const QString &name = QString())
Crea un nuevo diseño con los valores proporcionados en parent y name, utilizando la clase especificada en className.
La clase QUiLoader también utiliza esta función internamente cada vez que crea un diseño. Por lo tanto, puedes crear una subclase de QUiLoader y reimplementar esta función para intervenir en el proceso de construcción de una interfaz de usuario o un widget. Sin embargo, en tu implementación, asegúrate de llamar primero a la versión de QUiLoader.
Véase también createWidget() y load().
[virtual] QWidget *QUiLoader::createWidget(const QString &className, QWidget *parent = nullptr, const QString &name = QString())
Crea un nuevo widget con los valores de « parent » y « name » proporcionados, utilizando la clase especificada por « className ». Puedes utilizar esta función para crear cualquiera de los widgets devueltos por la función « availableWidgets()».
La clase QUiLoader también utiliza esta función internamente cada vez que crea un widget. Por lo tanto, puedes crear una subclase de QUiLoader y reimplementar esta función para intervenir en el proceso de construcción de una interfaz de usuario o de un widget. Sin embargo, en tu implementación, asegúrate de llamar primero a la versión de QUiLoader.
Véase también ` availableWidgets()` y ` load()`.
QString QUiLoader::errorString() const
Devuelve una descripción comprensible para el usuario del último error que se ha producido en load().
Véase también load().
bool QUiLoader::isLanguageChangeEnabled() const
Devuelve ` true ` si la retraducción dinámica al cambiar de idioma está habilitada; en caso contrario, devuelve ` false `.
El valor por defecto es ` false`.
Véase también setLanguageChangeEnabled().
QWidget *QUiLoader::load(QIODevice *device, QWidget *parentWidget = nullptr)
Crea una instancia de un formulario a partir del archivo « device » proporcionado. Devuelve un nuevo objeto « QWidget » con el « parentWidget » indicado si la operación se realiza correctamente. En caso contrario, devuelve un objeto « nullptr ».
Advertencia: Cargaúnicamente formularios procedentes de fuentes de confianza, como el sistema de recursos de Qt. La carga de archivos .ui procedentes de fuentes no fiables puede dar lugar a amenazas de seguridad en tu aplicación, tales como ataques de denegación de servicio, engaños en la interfaz de usuario o la carga de complementos inesperados.
Véase también createWidget() y errorString().
QStringList QUiLoader::pluginPaths() const
Devuelve una lista con las rutas en las que el cargador buscará al localizar complementos de widgets personalizados.
Véase también addPluginPath() y clearPluginPaths().
void QUiLoader::setLanguageChangeEnabled(bool enabled)
Si enabled es verdadero, las interfaces de usuario cargadas por este cargador se volverán a traducir automáticamente al recibir un evento de cambio de idioma. De lo contrario, las interfaces de usuario no se volverán a traducir.
Véase también isLanguageChangeEnabled().
void QUiLoader::setWorkingDirectory(const QDir &dir)
Establece el directorio de trabajo del cargador en dir. El cargador buscará otros recursos, como iconos y archivos de recursos, en rutas relativas a este directorio.
Advertencia: Estableceúnicamente un directorio en el que confíes. Permitir que usuarios no de confianza creen o añadan contenido en el directorio de trabajo puede dar lugar a vulnerabilidades de seguridad.
Véase también workingDirectory().
QDir QUiLoader::workingDirectory() const
Devuelve el directorio de trabajo del cargador.
Véase también setWorkingDirectory().
© 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.