Класс QDesignerWidgetBoxInterface

Класс QDesignerWidgetBoxInterface позволяет управлять содержимым поля виджетов в Qt Designer. Подробнее...

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

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

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

QDesignerWidgetBoxInterface содержит набор функций, обычно используемых для управления содержимым поля виджетов в Qt Designer.

Qt Designer использует XML-файл для заполнения поля виджетов. Название этого файла является одной из свойств поля виджетов, и вы можете получить его, используя функцию fileName().

QDesignerWidgetBoxInterface также предоставляет функцию save(), которая сохраняет содержимое поля виджетов в файле, указанном в свойстве имени файла поля виджетов. Если вы внесли изменения в поле виджетов, например, добавив виджет в поле виджетов, не вызвав функцию save(), исходное содержимое можно восстановить, просто вызвав функцию load():

        QDesignerWidgetBoxInterface *widgetBox = 0:
        widgetBox = formEditor->widgetBox();

        widgetBox->load();

Класс QDesignerWidgetBoxInterface не предназначен для прямого экземплярирования. Вы можете получить интерфейс к полю виджетов Qt Designer, используя функцию QDesignerFormEditorInterface::widgetBox(). Указатель на текущий объект QDesignerFormEditorInterface Qt Designer (formEditor в примере выше) предоставляется параметром функции QDesignerCustomWidgetInterface::initialize(). При реализации плагина пользовательского виджета вы должны унаследовать класс QDesignerCustomWidgetInterface, чтобы предоставить свой плагин в Qt Designer.

Если вы хотите сохранить изменения и при этом сохранить исходное содержимое, вы можете использовать функцию save() в сочетании с функцией setFileName(), чтобы сохранить ваши изменения в другой файл. Сначала запомните имя исходного файла:

        QString originalFile = widgetBox->fileName();

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

Затем вы можете восстановить исходное содержимое поля виджетов, сбросив имя файла на исходный файл и вызвав load():

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

Аналогичным образом, вы можете позже использовать свой настроенный XML-файл:

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

См. также QDesignerFormEditorInterface.

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

QDesignerWidgetBoxInterface::QDesignerWidgetBoxInterface(QWidget *parent = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())

Создаёт интерфейс поля виджетов с заданным parent и указанными флагами окна.

[virtual] QDesignerWidgetBoxInterface::~QDesignerWidgetBoxInterface()

Удаляет интерфейс поля виджетов.

[pure virtual] QString QDesignerWidgetBoxInterface::fileName() const

Возвращает имя XML-файла, который Qt Designer в настоящее время использует для заполнения поля виджетов.

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

[pure virtual] bool QDesignerWidgetBoxInterface::load()

Заполняет поле виджетов Qt Designer, загружая (или перезагружая) текущий указанный XML-файл. Возвращает true, если файл успешно загружен; иначе false.

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

[pure virtual] bool QDesignerWidgetBoxInterface::save()

Сохраняет содержимое поля виджетов Qt Designer в файле, указанном функцией fileName(). Возвращает true, если содержимое успешно сохранено; иначе false.

См. также fileName() и setFileName().

[pure virtual] void QDesignerWidgetBoxInterface::setFileName(const QString &fileName)

Устанавливает XML-файл, который Qt Designer будет использовать для заполнения поля виджетов, на fileName. Вы должны вызвать load(), чтобы обновить поле виджетов новым XML-файлом.

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