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

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);
}

Documentation sur les fonctions membres

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

Crée un chargeur de formulaire avec l'parent ion fournie.

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

Détruit le chargeur.

void QUiLoader::addPluginPath(const QString &path)

Ajoute l'path on indiquée à la liste des chemins dans lesquels le chargeur effectuera ses recherches pour localiser les plugins.

Voir également pluginPaths() et clearPluginPaths().

QStringList QUiLoader::availableLayouts() const

Renvoie une liste de toutes les mises en page disponibles pouvant être créées à l'aide de la fonction createLayout().

Voir aussi createLayout().

QStringList QUiLoader::availableWidgets() const

Renvoie une liste de tous les widgets disponibles pouvant être créés à l'aide de la fonction createWidget(), c'est-à-dire tous les widgets spécifiés dans les chemins d'accès aux plugins indiqués.

Voir également pluginPaths() et createWidget().

void QUiLoader::clearPluginPaths()

Efface la liste des chemins dans lesquels le chargeur effectuera ses recherches lors de la localisation des plugins.

Voir également addPluginPath() et pluginPaths().

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

Crée une nouvelle action avec les paramètres « parent » et « name » indiqués.

Cette fonction est également utilisée en interne par la classe QUiLoader chaque fois qu’elle crée une action. Vous pouvez donc créer une sous-classe de QUiLoader et réimplémenter cette fonction pour intervenir dans le processus de construction d’une interface utilisateur ou d’un widget. Veillez toutefois, dans votre implémentation, à appeler d’abord la version de QUiLoader.

Voir également createActionGroup(), createWidget() et load().

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

Crée un nouveau groupe d'actions avec les paramètres parent et name indiqués.

Cette fonction est également utilisée en interne par la classe ` QUiLoader ` chaque fois qu’elle crée un groupe d’actions. Vous pouvez donc créer une sous-classe de ` QUiLoader ` et réimplémenter cette fonction pour intervenir dans le processus de construction d’une interface utilisateur ou d’un widget. Veillez toutefois, dans votre implémentation, à appeler d’abord la version de ` QUiLoader`.

Voir également createAction(), createWidget() et load().

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

Crée une nouvelle mise en page avec les paramètres « parent » et « name » fournis, en utilisant la classe spécifiée par « className ».

Cette fonction est également utilisée en interne par la classe QUiLoader chaque fois qu’elle crée une mise en page. Vous pouvez donc créer une sous-classe de QUiLoader et réimplémenter cette fonction pour intervenir dans le processus de construction d’une interface utilisateur ou d’un widget. Veillez toutefois, dans votre implémentation, à appeler d’abord la version de QUiLoader.

Voir également createWidget() et load().

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

Crée un nouveau widget avec les paramètres ` parent ` et ` name ` fournis, en utilisant la classe spécifiée par ` className`. Vous pouvez utiliser cette fonction pour créer n'importe lequel des widgets renvoyés par la fonction ` availableWidgets()`.

Cette fonction est également utilisée en interne par la classe QUiLoader chaque fois qu’elle crée un widget. Vous pouvez donc créer une sous-classe de QUiLoader et réimplémenter cette fonction pour intervenir dans le processus de construction d’une interface utilisateur ou d’un widget. Veillez toutefois, dans votre implémentation, à appeler d’abord la version de QUiLoader.

Voir également availableWidgets() et load().

QString QUiLoader::errorString() const

Renvoie une description compréhensible par l'utilisateur de la dernière erreur survenue dans load().

Voir également load().

bool QUiLoader::isLanguageChangeEnabled() const

Renvoie « true » si la retranslation dynamique en cas de changement de langue est activée ; renvoie « false » dans le cas contraire.

La valeur par défaut est false.

Voir également setLanguageChangeEnabled().

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

Instancie un formulaire à partir du fichier ` device` fourni. Renvoie un nouvel objet ` QWidget ` avec le ` parentWidget ` fourni en cas de réussite. Renvoie ` nullptr ` dans le cas contraire.

Voir également createWidget() et errorString().

QStringList QUiLoader::pluginPaths() const

Renvoie une liste indiquant les chemins dans lesquels le chargeur effectuera ses recherches pour localiser les plugins de widgets personnalisés.

Voir également addPluginPath() et clearPluginPaths().

void QUiLoader::setLanguageChangeEnabled(bool enabled)

Si la valeur de enabled est « true », les interfaces utilisateur chargées par ce chargeur seront automatiquement retraduites dès qu'un événement de changement de langue sera détecté. Dans le cas contraire, les interfaces utilisateur ne seront pas retraduites.

Voir également isLanguageChangeEnabled().

void QUiLoader::setWorkingDirectory(const QDir &dir)

Définit le répertoire de travail du chargeur sur dir. Le chargeur recherchera d'autres ressources, telles que des icônes et des fichiers de ressources, dans des chemins relatifs à ce répertoire.

Voir également workingDirectory().

QDir QUiLoader::workingDirectory() const

Renvoie le répertoire de travail du chargeur.

Voir aussi setWorkingDirectory().