Класс QDesignerWidgetBoxInterface

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

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

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

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

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

• 59 свойств, унаследованных от 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(). Указатель на текущий объект 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 и указанными флагами окна 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().