The QDesignerCustomWidgetInterface class enables Qt Designer to access and construct custom widgets. 更多...
头: | #include <QDesignerCustomWidgetInterface> |
CMake: |
find_package(Qt6 COMPONENTS Designer REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Designer) |
qmake: | QT += designer |
virtual | ~QDesignerCustomWidgetInterface () |
virtual QString | codeTemplate () const |
virtual QWidget * | createWidget (QWidget * parent ) = 0 |
virtual QString | domXml () const |
virtual QString | group () const = 0 |
virtual QIcon | icon () const = 0 |
virtual QString | includeFile () const = 0 |
virtual void | initialize (QDesignerFormEditorInterface * formEditor ) |
virtual bool | isContainer () const = 0 |
virtual bool | isInitialized () const |
virtual QString | name () const = 0 |
virtual QString | toolTip () const = 0 |
virtual QString | whatsThis () const = 0 |
QDESIGNER_WIDGET_EXPORT |
QDesignerCustomWidgetInterface provides a custom widget with an interface. The class contains a set of functions that must be subclassed to return basic information about the widget, such as its class name and the name of its header file. Other functions must be implemented to initialize the plugin when it is loaded, and to construct instances of the custom widget for Qt Designer to use.
When implementing a custom widget you must subclass QDesignerCustomWidgetInterface to expose your widget to Qt Designer . For example, this is the declaration for the plugin used in the Custom Widget Plugin example that enables an analog clock custom widget to be used by Qt Designer :
class AnalogClockPlugin : public QObject, public QDesignerCustomWidgetInterface { Q_OBJECT Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetInterface") Q_INTERFACES(QDesignerCustomWidgetInterface) public: explicit AnalogClockPlugin(QObject *parent = nullptr); bool isContainer() const override; bool isInitialized() const override; QIcon icon() const override; QString domXml() const override; QString group() const override; QString includeFile() const override; QString name() const override; QString toolTip() const override; QString whatsThis() const override; QWidget *createWidget(QWidget *parent) override; void initialize(QDesignerFormEditorInterface *core) override; private: bool initialized = false; };
Note that the only part of the class definition that is specific to this particular custom widget is the class name. In addition, since we are implementing an interface, we must ensure that it's made known to the meta object system using the Q_INTERFACES () macro. This enables Qt Designer 要使用 qobject_cast () function to query for supported interfaces using nothing but a QObject 指针。
后于 Qt Designer loads a custom widget plugin, it calls the interface's initialize () function to enable it to set up any resources that it may need. This function is called with a QDesignerFormEditorInterface parameter that provides the plugin with a gateway to all of Qt Designer 's API.
Qt Designer constructs instances of the custom widget by calling the plugin's createWidget () function with a suitable parent widget. Plugins must construct and return an instance of a custom widget with the specified parent widget.
Exporting your custom widget plugin to
Qt Designer
使用
Q_PLUGIN_METADATA
() macro. For example, if a library called
libcustomwidgetplugin.so
(on Unix) or
libcustomwidget.dll
(on Windows) contains a widget class called
MyCustomWidget
, we can export it by adding the following line to the file containing the plugin header:
Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetInterface")
This macro ensures that Qt Designer can access and construct the custom widget. Without this macro, there is no way for Qt Designer to use it.
When implementing a custom widget plugin, you build it as a separate library. If you want to include several custom widget plugins in the same library, you must in addition subclass QDesignerCustomWidgetCollectionInterface .
警告: If your custom widget plugin contains QVariant properties, be aware that only the following types are supported:
For a complete example using the QDesignerCustomWidgetInterface class, see the Custom Widget Example . The example shows how to create a custom widget plugin for Qt Designer .
另请参阅 QDesignerCustomWidgetCollectionInterface and 创建自定义 Widget 为 Qt Designer .
[virtual]
QDesignerCustomWidgetInterface::
~QDesignerCustomWidgetInterface
()
Destroys the custom widget interface.
[virtual]
QString
QDesignerCustomWidgetInterface::
codeTemplate
() const
This function is reserved for future use by Qt Designer .
[pure virtual]
QWidget
*QDesignerCustomWidgetInterface::
createWidget
(
QWidget
*
parent
)
Returns a new instance of the custom widget, with the given parent .
[virtual]
QString
QDesignerCustomWidgetInterface::
domXml
() const
Returns the XML that is used to describe the custom widget's properties to Qt Designer .
[pure virtual]
QString
QDesignerCustomWidgetInterface::
group
() const
Returns the name of the group to which the custom widget belongs.
[pure virtual]
QIcon
QDesignerCustomWidgetInterface::
icon
() const
Returns the icon used to represent the custom widget in Qt Designer 's widget box.
[pure virtual]
QString
QDesignerCustomWidgetInterface::
includeFile
() const
Returns the path to the include file that uic uses when creating code for the custom widget.
[virtual]
void
QDesignerCustomWidgetInterface::
initialize
(
QDesignerFormEditorInterface
*
formEditor
)
Initializes the widget for use with the specified formEditor 接口。
另请参阅 isInitialized ().
[pure virtual]
bool
QDesignerCustomWidgetInterface::
isContainer
() const
Returns true if the custom widget is intended to be used as a container; otherwise returns false.
Most custom widgets are not used to hold other widgets, so their implementations of this function will return false, but custom containers will return true to ensure that they behave correctly in Qt Designer .
[virtual]
bool
QDesignerCustomWidgetInterface::
isInitialized
() const
Returns true if the widget has been initialized; otherwise returns false.
另请参阅 initialize ().
[pure virtual]
QString
QDesignerCustomWidgetInterface::
name
() const
Returns the class name of the custom widget supplied by the interface.
The name returned must be identical to the class name used for the custom widget.
[pure virtual]
QString
QDesignerCustomWidgetInterface::
toolTip
() const
Returns a short description of the widget that can be used by Qt Designer in a tool tip.
[pure virtual]
QString
QDesignerCustomWidgetInterface::
whatsThis
() const
Returns a description of the widget that can be used by Qt Designer in "What's This?" help for the widget.
This macro is used when defining custom widgets to ensure that they are correctly exported from plugins for use with Qt Designer .
On some platforms, the symbols required by Qt Designer to create new widgets are removed from plugins by the build system, making them unusable. Using this macro ensures that the symbols are retained on those platforms, and has no side effects on other platforms.
例如, World Time Clock Plugin example exports a custom widget class with the following declaration:
class QDESIGNER_WIDGET_EXPORT WorldTimeClock : public QWidget { Q_OBJECT ... };
另请参阅 创建自定义 Widget 为 Qt Designer .