QDesignerWidgetBoxInterface Class

Description détaillée

QDesignerWidgetBoxInterface contient un ensemble de fonctions généralement utilisées pour manipuler le contenu de la boîte à widgets d'Qt Widgets Designer.

Qt Widgets Designer utilise un fichier XML pour remplir sa boîte à widgets. Le nom de ce fichier est l'une des propriétés de la boîte à widgets, 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 à widgets dans le fichier spécifié par la propriété « nom de fichier » de la boîte à widgets. Si vous avez apporté des modifications à la boîte de widgets, par exemple en y déposant un widget, sans appeler la fonction ` save()`, le contenu d’origine peut être restauré par un simple appel à la fonction ` load()` :

        auto *widgetBox = formEditor->widgetBox();

        widgetBox->load();

Qt Widgets La classe `QDesignerWidgetBoxInterface` n’est pas destinée à être instanciée directement. Vous pouvez récupérer une interface vers la boîte à widgets de Qt Designer à l’aide de la fonction QDesignerFormEditorInterface::widgetBox(). Un pointeur vers l’objet QDesignerFormEditorInterface actuel de Designer (formEditor dans l’exemple ci-dessus) est fourni par le paramètre de la fonction QDesignerCustomWidgetInterface::initialize(). Lors de l’implémentation d’un plugin de widget personnalisé, vous devez créer une sous-classe de QDesignerCustomWidgetInterface afin d’exposer votre plugin à Qt Widgets Designer.

Si vous souhaitez enregistrer vos modifications tout en conservant le contenu d’origine, vous pouvez utiliser la fonction ` save()` combinée à la fonction ` setFileName()` pour enregistrer vos modifications dans un autre fichier. N’oubliez pas de stocker au préalable le nom du fichier d’origine :

        QString originalFile = widgetBox->fileName();

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

Vous pouvez ensuite restaurer le contenu d’origine de la boîte de widget en réinitialisant le nom du fichier sur celui du fichier d’origine et en appelant load() :

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

De la même manière, vous pourrez par la suite utiliser votre fichier XML personnalisé :

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