QUiLoader Class

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 = newQVBoxLayout;
    layout->addWidget(myWidget);
    setLayout(layout);
}

QWidget*loadCustomWidget(constQString&className,QWidget*parent)
{
    QUiLoader loader;
    QStringList availableWidgets=loader.availableWidgets();

    if(!availableWidgets.contains(className)) {
        qWarning() << "Cannot create widget" << className;
       returnnullptr;
    }

    returnloader.createWidget(className,parent);
}

成员函数文档

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

使用给定的parent 创建一个表单加载器。

[override virtual noexcept] QUiLoader::~QUiLoader()

摧毁装载机。

void QUiLoader::addPluginPath(const QString &path)

将给定的path 添加到加载器在查找插件时会搜索的路径列表中。

另请参阅 pluginPaths() 和clearPluginPaths()。

QStringList QUiLoader::availableLayouts() const

返回一个列表，其中包含所有可使用createLayout()函数构建的可用布局。

另请参阅 createLayout()。

QStringList QUiLoader::availableWidgets() const

返回一个列表，其中包含所有可通过createWidget()函数构建的可用控件，即给定插件路径中指定的所有控件。

另请参阅 pluginPaths() 和createWidget()。

void QUiLoader::clearPluginPaths()

清除加载器在查找插件时将搜索的路径列表。

另请参阅 addPluginPath() 和pluginPaths()。

[virtual] QAction *QUiLoader::createAction(QObject *parent = nullptr, const QString &name = QString())

使用给定的parent 和name 创建一个新的操作。

QUiLoader 类在创建操作时，内部也会使用该函数。因此，您可以继承QUiLoader 类并重写此函数，以干预用户界面或控件的构建过程。但在您的实现中，请确保先调用QUiLoader 的版本。

另请参阅 createActionGroup()、createWidget() 和load()。

[virtual] QActionGroup *QUiLoader::createActionGroup(QObject *parent = nullptr, const QString &name = QString())

创建一个新的操作组，其parent 和name 参数为给定值。

该函数还被QUiLoader 类在内部用于每次创建操作组时。因此，您可以继承QUiLoader 并重写此函数，以干预用户界面或控件的构建过程。但在您的实现中，请确保先调用QUiLoader 的版本。

另请参阅 createAction()、createWidget() 和load()。

[virtual] QLayout *QUiLoader::createLayout(const QString &className, QObject *parent = nullptr, const QString &name = QString())

使用由className 指定的类，基于给定的parent 和name 创建一个新的布局。

QUiLoader 类在创建布局时也会在内部调用此函数。因此，您可以继承QUiLoader 类并重写此函数，以干预用户界面或控件的构建过程。但在您的实现中，请确保先调用QUiLoader 的版本。

另请参阅 createWidget() 和load()。

[virtual] QWidget *QUiLoader::createWidget(const QString &className, QWidget *parent = nullptr, const QString &name = QString())

使用由className 指定的类，根据给定的parent 和name 创建一个新的控件。您可以使用此函数来创建由availableWidgets() 函数返回的任何控件。

QUiLoader 类在创建控件时，内部也会使用此函数。因此，您可以继承QUiLoader 类并重写此函数，以干预用户界面或控件的构造过程。但在您的实现中，请确保先调用QUiLoader 中定义的版本。

另请参阅 availableWidgets() 和load()。

QString QUiLoader::errorString() const

返回load() 中发生的最后一个错误的通俗易懂描述。

另请参阅 load()。

bool QUiLoader::isLanguageChangeEnabled() const

如果启用了语言变更时的动态重新翻译，则返回true ；否则返回false 。

默认值为false 。

另请参阅 setLanguageChangeEnabled()。

QWidget *QUiLoader::load(QIODevice *device, QWidget *parentWidget = nullptr)

根据给定的device 实例化一个表单。若成功，则返回一个带有给定parentWidget 的新QWidget 对象；否则返回nullptr 。

另请参阅 createWidget() 和errorString()。

QStringList QUiLoader::pluginPaths() const

返回一个列表，其中列出了加载器在查找自定义控件插件时将搜索的路径。

另请参阅 addPluginPath() 和clearPluginPaths()。

void QUiLoader::setLanguageChangeEnabled(bool enabled)

如果enabled 为真，则由该加载器加载的用户界面在收到语言更改事件时会自动重新翻译。否则，用户界面将不会被重新翻译。

另请参阅 isLanguageChangeEnabled()。

void QUiLoader::setWorkingDirectory(const QDir &dir)

将加载器的作业目录设置为dir 。加载器将在此目录的相对路径下查找其他资源，例如图标和资源文件。

另请参阅 workingDirectory()。

QDir QUiLoader::workingDirectory() const

返回加载器的当前工作目录。

另请参阅 setWorkingDirectory()。