QDesignerWidgetBoxInterface Class
QDesignerWidgetBoxInterface クラスを使用すると、Qt Widgets Designer のウィジェット・ボックスの内容を制御できます。詳細...
| ヘッダー | #include <QDesignerWidgetBoxInterface> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Designer)target_link_libraries(mytarget PRIVATE Qt6::Designer) |
| qmake： | QT += designer |
| 継承： | QWidget |
パブリック関数
| QDesignerWidgetBoxInterface(QWidget *parent = 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 |
詳細説明
QDesignerWidgetBoxInterface には、Qt Widgets Designer のウィジェットボックスの内容を操作するために通常使用される関数のコレクションが含まれています。
Qt Widgets Designer は XML ファイルを使用してウィジェット ボックスを生成します。そのファイル名はウィジェットボックスのプロパティの1つで、 （）関数を使用して取得できます。fileName
QDesignerWidgetBoxInterfaceには、ウィジェット・ボックスのファイル名プロパティで指定されたファイルにウィジェット・ボックスの内容を保存するsave （）関数も用意されています。save （）関数を呼び出さずにウィジェット・ボックスにウィジェットをドロップするなどしてウィジェット・ボックスに変更を加えた場合、load （）関数を呼び出すだけで元の内容を復元することができます：
auto *widgetBox = formEditor->widgetBox(); widgetBox->load();
QDesignerWidgetBoxInterfaceクラスは、直接インスタンス化することを意図していません。QDesignerWidgetBoxInterface クラスは、直接インスタンス化することを意図していません。QDesignerFormEditorInterface::widgetBox() 関数を使用して、Qt Designer'のウィジェット・ボックスへのインターフェイスを取得できます。Qt Widgets Designerの現在のQDesignerFormEditorInterface オブジェクト（上記の例ではformEditor ）へのポインタは、QDesignerCustomWidgetInterface::initialize （）関数のパラメータで提供されます。カスタム ウィジェット プラグインを実装する場合は、QDesignerCustomWidgetInterface をサブクラス化してプラグインをQt Widgets 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も参照 。
メンバ関数ドキュメント
[explicit] QDesignerWidgetBoxInterface::QDesignerWidgetBoxInterface(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
与えられたparent と指定されたウィンドウflags を持つウィジェットボックスインターフェイスを構築します。
[virtual noexcept] QDesignerWidgetBoxInterface::~QDesignerWidgetBoxInterface()
ウィジェットボックスのインターフェイスを破壊する。
[pure virtual] QString QDesignerWidgetBoxInterface::fileName() const
Qt Widgets Designer がウィジェット・ボックスの入力に現在使用している XML ファイルの名前を返します。
setFileName()も参照してください 。
[pure virtual] bool QDesignerWidgetBoxInterface::load()
現在指定されている XML ファイルをロード（または再ロード）することにより、Qt Widgets Designer のウィジェット ボックスにデータを入力します。ファイルが正常に読み込まれた場合は true を返し、そうでない場合は false を返します。
setFileName()も参照してください 。
[pure virtual] bool QDesignerWidgetBoxInterface::save()
fileName() 関数で指定されたファイルにQt Widgets Designer のウィジェット・ボックスの内容を保存します。コンテンツが正常に保存された場合は true を返し、そうでない場合は false を返します。
fileName() およびsetFileName()も参照してください 。
[pure virtual] void QDesignerWidgetBoxInterface::setFileName(const QString &fileName)
fileName に、Qt Widgets Designer がウィジェット・ボックスの入力に使用する XML ファイルを設定します。新しい XML ファイルでウィジェット・ボックスを更新するには、load() を呼び出す必要があります。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
