内容

公共函数
静态公共成员
详细描述

QDesignerWidgetBoxInterface Class

The QDesignerWidgetBoxInterface class allows you to control the contents of Qt Designer's widget box. 更多...

头：	#include <QDesignerWidgetBoxInterface>
qmake:	QT += designer
继承：	QWidget

公共函数

	QDesignerWidgetBoxInterface (QWidget * parent = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())
virtual	~QDesignerWidgetBoxInterface ()
virtual QString	fileName () const = 0
virtual bool	load () = 0
virtual bool	save () = 0
virtual void	setFileName (const QString & fileName ) = 0

216 公共函数继承自 QWidget

静态公共成员

const QMetaObject

staticMetaObject

5 静态公共成员继承自 QWidget

额外继承成员

59 特性继承自 QWidget
19 公共槽继承自 QWidget
3 信号继承自 QWidget
35 保护函数继承自 QWidget
1 保护槽继承自 QWidget

详细描述

The QDesignerWidgetBoxInterface class allows you to control the contents of Qt Designer's widget box.

QDesignerWidgetBoxInterface contains a collection of functions that is typically used to manipulate the contents of Qt Designer 's widget box.

Qt Designer uses an XML file to populate its widget box. The name of that file is one of the widget box's properties, and you can retrieve it using the fileName () 函数。

QDesignerWidgetBoxInterface 还提供 save () function that saves the contents of the widget box in the file specified by the widget box's file name property. If you have made changes to the widget box, for example by dropping a widget into the widget box, without calling the save () function, the original content can be restored by a simple invocation of the load () 函数：

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

The QDesignerWidgetBoxInterface class is not intended to be instantiated directly. You can retrieve an interface to Qt Designer's widget box using the QDesignerFormEditorInterface::widgetBox () function. A pointer to Qt Designer 's current QDesignerFormEditorInterface object ( formEditor in the example above) is provided by the QDesignerCustomWidgetInterface::initialize () function's parameter. When implementing a custom widget plugin, you must subclass the QDesignerCustomWidgetInterface to expose your plugin to Qt Designer .

If you want to save your changes, and at the same time preserve the original contents, you can use the save () function combined with the setFileName () function to save your changes into another file. Remember to store the name of the original file first:

        QString originalFile = widgetBox->fileName();
        widgetBox->setFileName("myWidgetBox.xml");
        widgetBox->save();

Then you can restore the original contents of the widget box by resetting the file name to the original file and calling load ():

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

In a similar way, you can later use your customized XML file:

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

另请参阅 QDesignerFormEditorInterface .

成员函数文档编制

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

Constructs a widget box interface with the given parent and the specified window flags .

`[虚拟]` QDesignerWidgetBoxInterface:: ~QDesignerWidgetBoxInterface ()

Destroys the widget box interface.

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

Returns the name of the XML file Qt Designer is currently using to populate its widget box.

另请参阅 setFileName ().

`[pure virtual]` bool QDesignerWidgetBoxInterface:: load ()

Populates Qt Designer 's widget box by loading (or reloading) the currently specified XML file. Returns true if the file is successfully loaded; otherwise false.

另请参阅 setFileName ().

`[pure virtual]` bool QDesignerWidgetBoxInterface:: save ()

Saves the contents of Qt Designer 's widget box in the file specified by the fileName () function. Returns true if the content is successfully saved; otherwise false.

另请参阅 fileName () 和 setFileName ().

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

Sets the XML file that Qt Designer will use to populate its widget box, to fileName . You must call load () to update the widget box with the new XML file.

另请参阅 fileName () 和 load ().

内容