QDesignerCustomWidgetInterface Class

詳細説明

QDesignerCustomWidgetInterfaceは、インターフェイスを持つカスタムウィジェットを提供します。このクラスには、クラス名やヘッダー・ファイル名など、ウィジェットに関する基本情報を返すためにサブクラス化する必要がある一連の関数が含まれています。その他の関数は、プラグインがロードされたときに初期化し、Qt Widgets Designer が使用するカスタムウィジェットのインスタンスを構築するために実装する必要があります。

カスタム ウィジェットを実装する場合は、QDesignerCustomWidgetInterface をサブクラス化して、ウィジェットをQt Widgets Designer に公開する必要があります。例えば、これはCustom Widget Pluginの例で使用されるプラグインの宣言で、アナログ時計のカスタムウィジェットをQt Widgets 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;
};

クラス定義のうち、この特定のカスタムウィジェットに固有の部分はクラス名だけであることに注意してください。また、インターフェイスを実装しているため、Q_INTERFACES() マクロを使用してメタ オブジェクト システムに知らせる必要があります。これにより、Qt Widgets Designer はqobject_cast() 関数を使用して、QObject ポインタのみを使用してサポートされているインターフェイスを照会できます。

Qt Widgets Designerがカスタムウィジェットプラグインをロードした後、インターフェイスのinitialize （）関数を呼び出して、必要なリソースをセットアップできるようにします。この関数はQDesignerFormEditorInterface パラメータとともに呼び出され、プラグインにQt Widgets Designer のすべての API へのゲートウェイを提供します。

Qt Widgets Designer は、適切な親ウィジェットを使用してプラグインの () 関数を呼び出すことで、カスタムウィジェットのインスタンスを構築します。プラグインは、指定された親ウィジェットでカスタムウィジェットのインスタンスを構築して返す必要があります。createWidget

Q_PLUGIN_METADATA() マクロを使用して、カスタムウィジェットプラグインをQt Widgets Designer にエクスポートします。たとえば、libcustomwidgetplugin.so （Unix の場合）またはlibcustomwidget.dll （Windows の場合）というライブラリにMyCustomWidget というウィジェット・クラスが含まれている場合、プラグイン・ヘッダを含むファイルに次の行を追加することでエクスポートできます：

Q_PLUGIN_METADATA(IID "org.qt-project.Qt.QDesignerCustomWidgetInterface")

このマクロにより、Qt Widgets Designer がカスタム ウィジェットにアクセスして構築できるようになります。このマクロがないと、Qt Widgets Designer で使用できません。

カスタムウィジェットプラグインを実装する場合、別のライブラリとして構築します。複数のカスタム ウィジェット プラグインを同じライブラリに含める場合は、さらにQDesignerCustomWidgetCollectionInterface をサブクラス化する必要があります。

• QVariant::ByteArray
• QVariant::Bool
• QVariant::Color
• QVariant::Cursor
• QVariant::Date
• QVariant::DateTime
• QVariant::Double
• QVariant::Int
• QVariant::Point
• QVariant::Rect
• QVariant::Size
• QVariant::SizePolicy (サイズポリシー)
• QVariant::String
• QVariant::Time
• QVariant::UInt

QDesignerCustomWidgetInterfaceクラスを使用した完全な例については、カスタムウィジェットの例を参照してください。この例では、Qt Widgets Designer用のカスタムウィジェットプラグインを作成する方法を示します。