Класс QUiLoader

Класс QUiLoader позволяет автономным приложениям динамически создавать пользовательские интерфейсы во время выполнения, используя информацию, хранящуюся в файлах интерфейса или указанных в путях плагинов. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

• 34 открытых функций, унаследованных от QObject

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QObject
• 1 открытый слот, унаследованный от QObject
• 2 сигнала, унаследованные от QObject
• 1 открытая переменная, унаследованная от QObject
• 10 статических открытых членов, унаследованных от QObject
• 9 защищённых функций, унаследованных от QObject
• 2 защищённые переменные, унаследованные от QObject

Подробное описание

Класс QUiLoader позволяет автономным приложениям динамически создавать пользовательские интерфейсы во время выполнения, используя информацию, хранящуюся в файлах интерфейса или указанных в путях плагинов.

Кроме того, вы можете настроить или создать свой собственный пользовательский интерфейс, создав свой собственный класс загрузчика.

Если у вас есть пользовательский компонент или приложение, которое встраивает Qt Designer, вы также можете использовать класс QFormBuilder, предоставленный модулем QtDesigner, для создания пользовательских интерфейсов из файлов интерфейса.

Класс QUiLoader предоставляет набор функций, позволяющих создавать виджеты на основе информации, хранящейся в файлах интерфейса (созданных с помощью Qt Designer) или доступных в указанных путях плагинов. Указанные пути плагинов можно получить, используя функцию pluginPaths(). Аналогично, содержимое файла интерфейса можно получить, используя функцию load(). Например:

MyWidget::MyWidget(QWidget *parent)
    : QWidget(parent)
{
    QUiLoader loader;
    QFile file(":/forms/myform.ui");
    file.open(QFile::ReadOnly);
    QWidget *myWidget = loader.load(&file, this);
    file.close();

    QVBoxLayout *layout = new QVBoxLayout;
    layout->addWidget(myWidget);
    setLayout(layout);
}

Включив пользовательский интерфейс в ресурсы формы (myform.qrc), мы гарантируем, что он будет присутствовать во время выполнения:

<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/forms">
<file>myform.ui</file>
</qresource>
</RCC>

Функция availableWidgets() возвращает QStringList с именами классов виджетов, доступных в указанных путях плагинов. Для создания этих виджетов просто используйте функцию createWidget(). Например:

QWidget *loadCustomWidget(QWidget *parent)
{
    QUiLoader loader;
    QWidget *myWidget;

    QStringList availableWidgets = loader.availableWidgets();

    if (availableWidgets.contains("AnalogClock"))
        myWidget = loader.createWidget("AnalogClock", parent);

    return myWidget;
}

Чтобы сделать пользовательский виджет доступным для загрузчика, вы можете использовать функцию addPluginPath(); чтобы удалить все доступные виджеты, вы можете вызвать функцию clearPluginPaths().

Функции createAction(), createActionGroup(), createLayout() и createWidget() используются внутри класса QUiLoader всякий раз, когда он должен создать действие, группу действий, макет или виджет соответственно. Поэтому вы можете подклассировать класс QUiLoader и переопределить эти функции, чтобы вмешаться в процесс построения пользовательского интерфейса. Например, вы можете захотеть иметь список созданных действий при загрузке формы или создании пользовательского виджета.

Полный пример использования класса QUiLoader см. в примере Пример Калькуляторного Построителя.

См. также Qt UI Tools и QFormBuilder.

Документация по функциям-членам

QUiLoader::QUiLoader(QObject *parent = nullptr)

Создаёт загрузчик форм с заданным parent.

[virtual] QUiLoader::~QUiLoader()

Удаляет загрузчик.

void QUiLoader::addPluginPath(const QString &path)

Добавляет заданный path в список путей, по которым загрузчик будет искать плагины.

См. также pluginPaths() и clearPluginPaths().

QStringList QUiLoader::availableLayouts() const

Возвращает список имён всех доступных макетов, которые можно создать с помощью функции createLayout().

Функция была введена в Qt 4.5.

См. также 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())

Создает новый макет с заданным parent и name, используя класс, указанный в className.

Функция также используется внутри класса QUiLoader, когда он создает виджет. Поэтому вы можете наследовать от QUiLoader и переопределить эту функцию, чтобы вмешаться в процесс создания пользовательского интерфейса или виджета. Однако в вашей реализации убедитесь, что вы сначала вызываете версию QUiLoader.

См. также createWidget() и load().

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

Создаёт новый виджет с заданным parent и name, используя класс, указанный в className. Вы можете использовать эту функцию для создания любого из виджетов, возвращаемых функцией availableWidgets().

Функция также используется внутри класса QUiLoader, когда он создаёт виджет. Поэтому вы можете наследовать от QUiLoader и переопределить эту функцию, чтобы вмешаться в процесс создания пользовательского интерфейса или виджета. Однако в вашей реализации убедитесь, что вы сначала вызываете версию QUiLoader.

См. также availableWidgets() и load().

QString QUiLoader::errorString() const

Возвращает удобочитаемое описание последней ошибки, произошедшей в load().

Эта функция была добавлена в Qt 5.0.

См. также load().

bool QUiLoader::isLanguageChangeEnabled() const

Возвращает true, если динамический повторный перевод при изменении языка включён; в противном случае возвращает false.

Эта функция была добавлена в Qt 4.5.

См. также setLanguageChangeEnabled().

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

Загружает форму из заданного device и создаёт новый виджет с заданным parentWidget для размещения его содержимого.

См. также createWidget() и errorString().

QStringList QUiLoader::pluginPaths() const

Возвращает список путей, в которых загрузчик будет искать пользовательские плагины виджетов.

См. также addPluginPath() и clearPluginPaths().

void QUiLoader::setLanguageChangeEnabled(bool enabled)

Если enabled равно true, пользовательские интерфейсы, загруженные этим загрузчиком, будут автоматически переводиться при получении события изменения языка. В противном случае пользовательские интерфейсы не будут переводиться.

Эта функция была добавлена в Qt 4.5.

См. также isLanguageChangeEnabled().

void QUiLoader::setWorkingDirectory(const QDir &dir)

Устанавливает рабочую директорию загрузчика в dir. Загрузчик будет искать другие ресурсы, такие как значки и файлы ресурсов, в путях, относительных к этой директории.

См. также workingDirectory().

QDir QUiLoader::workingDirectory() const

Возвращает рабочую директорию загрузчика.

См. также setWorkingDirectory().