QDesignerCustomWidgetInterface Class

상세 설명

QDesignerCustomWidgetInterface는 인터페이스를 가진 사용자 정의 위젯을 제공합니다. 이 클래스에는 클래스 이름 및 헤더 파일 이름과 같은 위젯에 대한 기본 정보를 반환하기 위해 서브 클래싱해야 하는 함수 집합이 포함되어 있습니다. 다른 함수는 플러그인이 로드될 때 초기화하고 Qt Widgets Designer 에서 사용할 사용자 정의 위젯의 인스턴스를 구성하기 위해 구현해야 합니다.

사용자 정의 위젯을 구현할 때 위젯을 Qt Widgets Designer 에 노출하려면 QDesignerCustomWidgetInterface 를 서브클래싱해야 합니다. 예를 들어, 다음은 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::커서
• 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 에 대한 사용자 지정 위젯 플러그인을 만드는 방법을 보여줍니다.