QFormBuilder Class

Description détaillée

La classe QFormBuilder fournit un mécanisme permettant de créer dynamiquement des interfaces utilisateur au moment de l'exécution, sur la base de fichiers d'interface utilisateur créés à l'aide de Qt Widgets Designer. Par exemple :

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

En incluant l'interface utilisateur dans les ressources de l'exemple (myForm.qrc), nous nous assurons qu'elle sera présente lors de l'exécution de l'exemple :

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

QFormBuilder étend la classe de base QAbstractFormBuilder avec un certain nombre de fonctions qui sont utilisées pour prendre en charge les plugins de widgets personnalisés :

• pluginPaths() renvoie la liste des chemins que le constructeur de formulaires recherche lors du chargement des plugins de widgets personnalisés.
• addPluginPath() permet d'enregistrer des chemins supplémentaires dans le générateur de formulaires.
• setPluginPath() est utilisé pour remplacer la liste de chemins existante par une liste obtenue à partir d'une autre source.
• clearPluginPaths() supprime tous les chemins enregistrés avec le constructeur de formulaires.
• customWidgets() renvoie une liste d'interfaces pour les plugins qui peuvent être utilisés pour créer de nouvelles instances de widgets personnalisés enregistrés.

La classe QFormBuilder est généralement utilisée par les composants personnalisés et les applications qui intègrent Qt Widgets Designer. Les applications autonomes qui doivent générer dynamiquement des interfaces utilisateur au moment de l'exécution utilisent la classe QUiLoader, qui se trouve dans le module QtUiTools.