QDesignerWidgetBoxInterface Class

Description détaillée

QDesignerWidgetBoxInterface contient une collection de fonctions typiquement utilisées pour manipuler le contenu de la boîte à outils de Qt Widgets Designer.

Qt Widgets Designer QDesignerWidgetBoxInterface utilise un fichier XML pour remplir sa boîte à outils. Le nom de ce fichier est l'une des propriétés de la boîte à outils et vous pouvez le récupérer à l'aide de la fonction fileName().

QDesignerWidgetBoxInterface fournit également la fonction save() qui enregistre le contenu de la boîte à outils dans le fichier spécifié par la propriété de nom de fichier de la boîte à outils. Si vous avez apporté des modifications à la boîte à outils, par exemple en y déposant un widget, sans appeler la fonction save(), le contenu original peut être restauré par une simple invocation de la fonction load() :

        auto *widgetBox = formEditor->widgetBox();

        widgetBox->load();

La classe QDesignerWidgetBoxInterface n'est pas destinée à être instanciée directement. Vous pouvez récupérer une interface pour la boîte à outils de Qt Designer à l'aide de la fonction QDesignerFormEditorInterface::widgetBox(). Un pointeur sur l'objet QDesignerFormEditorInterface actuel de Qt Widgets Designer(formEditor dans l'exemple ci-dessus) est fourni par le paramètre de la fonction QDesignerCustomWidgetInterface::initialize(). Lorsque vous implémentez un plugin de widget personnalisé, vous devez sous-classer l'objet QDesignerCustomWidgetInterface pour exposer votre plugin à Qt Widgets Designer.

Si vous souhaitez enregistrer vos modifications tout en préservant le contenu original, vous pouvez utiliser la fonction save() combinée à la fonction setFileName() pour enregistrer vos modifications dans un autre fichier. N'oubliez pas d'enregistrer d'abord le nom du fichier original :

        QString originalFile = widgetBox->fileName();

        widgetBox->setFileName("myWidgetBox.xml");
        widgetBox->save();

Vous pouvez ensuite restaurer le contenu original de la boîte à outils en réinitialisant le nom du fichier à celui du fichier original et en appelant load() :

        widgetBox->setFileName(originalFile);
        widgetBox->load();

De la même manière, vous pouvez utiliser ultérieurement votre fichier XML personnalisé :

        if (widgetBox->filename() != "myWidgetBox.xml") {
            widgetBox->setFileName("myWidgetBox.xml");
            widgetBox->load();
        }