Класс QDesignerWidgetBoxInterface

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

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

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

• 211 открытых функций, унаследованных от QWidget
• 31 открытых функций, унаследованных от QObject
• 14 открытых функций, унаследованных от QPaintDevice

Дополнительные наследуемые члены

• 58 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject
• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject
• 3 сигналов, унаследованных от QWidget
• 2 сигналов, унаследованных от QObject
• 5 статических открытых членов, унаследованных от QWidget
• 11 статических открытых членов, унаследованных от QObject
• 35 защищенных функций, унаследованных от QWidget
• 9 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованная от QPaintDevice
• 1 защищенный слот, унаследованный от QWidget

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

Класс 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(). Указатель на текущий объект Qt Designer QDesignerFormEditorInterface (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 и указанными флагами окна flags.

[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().