사용자 정의 위젯 확장 만들기

Qt Widgets Designer 에 대한 사용자 정의 위젯 플러그인이 있으면 사용자 정의 위젯 확장을 사용하여 Qt Widgets Designer 의 작업 영역 내에서 예상되는 동작과 기능을 제공할 수 있습니다.

확장 프로그램 유형

Qt Widgets Designer 에서 사용할 수 있는 확장 유형은 여러 가지가 있습니다. 이러한 모든 확장을 동일한 패턴으로 사용할 수 있으며 각 확장 기본 클래스만 교체하면 됩니다.

QDesignerContainerExtension 사용자 정의 다중 페이지 컨테이너를 구현할 때 필요합니다.

	QDesignerTaskMenuExtension QDesignerTaskMenuExtension 는 사용자 정의 위젯에 유용합니다. Qt Widgets Designer 의 작업 메뉴에 사용자 정의 메뉴 항목을 추가할 수 있는 확장 기능을 제공합니다. 작업 메뉴 확장 예제는 이 클래스를 사용하는 방법을 보여줍니다.
	QDesignerContainerExtension QDesignerContainerExtension 는 사용자 정의 다중 페이지 컨테이너를 구현할 때 필요합니다. Qt Widgets Designer 에서 다중 페이지 컨테이너 플러그인의 페이지를 추가하고 삭제할 수 있는 확장 기능을 제공합니다. 컨테이너 확장 예제에서는 이 클래스를 사용하는 방법을 자세히 설명합니다. 참고: 일부 위젯(예: QTabWidget)의 경우 구현 방식 때문에 페이지별 사용자 정의 속성을 추가할 수 없습니다.

	QDesignerMemberSheetExtension QDesignerMemberSheetExtension 클래스를 사용하면 신호와 슬롯을 연결할 때 표시되는 위젯의 멤버 함수를 조작할 수 있습니다.
	QDesignerPropertySheetExtension, QDesignerDynamicPropertySheetExtension 이러한 확장 클래스를 사용하면 Qt Widgets Designer 의 속성 편집기에서 위젯의 속성이 표시되는 방식을 제어할 수 있습니다.

Qt Widgets Designer 는 QDesignerPropertySheetExtension 및 QDesignerMemberSheetExtension 클래스를 사용하여 프로퍼티와 신호 및 슬롯 편집기를 공급합니다. 작업 영역에서 위젯이 선택될 때마다 Qt Widgets Designer 은 위젯의 속성 시트 확장을 쿼리하고, 마찬가지로 두 위젯 간의 연결이 요청될 때마다 Qt Widgets Designer 은 위젯의 멤버 시트 확장을 쿼리합니다.

확장 프로그램 만들기

확장 프로그램을 만들려면 QObject 및 적절한 기본 클래스를 모두 상속하고 그 기능을 다시 구현해야 합니다. 인터페이스를 구현하고 있으므로 확장 프로그램 클래스 정의에서 Q_INTERFACES() 매크로를 사용하여 메타 개체 시스템에 인터페이스를 알려야 합니다. 예를 들어

class MyExtension: public QObject,
                   public QdesignerContainerExtension
{
    Q_OBJECT
    Q_INTERFACE(QDesignerContainerExtension)

    ...
}

이렇게 하면 Qt Widgets Designer 에서 qobject_cast() 함수를 사용하여 QObject 포인터만 사용하여 지원되는 인터페이스를 쿼리할 수 있습니다.

확장 프로그램 노출 대상 Qt Widgets Designer

Qt Widgets Designer 에서 확장은 필요할 때까지 생성되지 않습니다. 따라서 확장을 구현할 때는 QExtensionFactory 을 서브클래싱하여 확장의 인스턴스를 만들 수 있는 클래스를 만들어야 합니다. 또한 Qt Widgets Designer 의 확장 관리자에게 팩토리를 등록해야 하며, 확장 관리자는 확장의 구성을 처리합니다.

확장이 요청되면 Qt Widgets Designer 의 확장 관리자는 선택한 위젯에 대해 요청된 확장을 만들 수 있는 팩토리를 찾을 때까지 등록된 팩토리에 대해 QExtensionFactory::createExtension()을 호출하여 각 팩토리를 실행합니다. 그러면 이 팩토리가 확장 프로그램의 인스턴스를 만듭니다.

확장팩토리 생성하기

QExtensionFactory 클래스는 표준 확장 팩토리를 제공하지만 사용자 정의 확장 팩토리를 위한 인터페이스로도 사용할 수 있습니다.

그 목적은 QExtensionFactory::createExtension() 함수를 재구현하여 멀티페이지위젯 컨테이너 확장과 같은 확장을 만들 수 있도록 하는 것입니다.

QExtensionFactory 을 새로 만들고 QExtensionFactory::createExtension() 함수를 다시 구현할 수 있습니다:

QObject *ANewExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    if (iid != Q_TYPEID(QDesignerContainerExtension))
        return 0;

    if (MyCustomWidget *widget = qobject_cast<MyCustomWidget*>
            (object))
        return new MyContainerExtension(widget, parent);

    return 0;
}

또는 기존 팩토리를 사용하여 QExtensionFactory::createExtension() 함수를 확장하여 팩토리에서도 사용자 정의 확장을 만들 수 있도록 할 수 있습니다:

QObject *AGeneralExtensionFactory::createExtension(QObject *object,
        const QString &iid, QObject *parent) const
{
    MyCustomWidget *widget = qobject_cast<MyCustomWidget*>(object);

    if (widget && (iid == Q_TYPEID(QDesignerTaskMenuExtension))) {
         return new MyTaskMenuExtension(widget, parent);

    } else if (widget && (iid == Q_TYPEID(QDesignerContainerExtension))) {
        return new MyContainerExtension(widget, parent);

    } else {
        return 0;
    }
}

Qt Widgets Designer 의 확장 관리자 액세스

사용자 정의 위젯 플러그인을 구현할 때는 QDesignerCustomWidgetInterface 을 서브클래스화하여 Qt Widgets Designer 에 플러그인을 노출해야 합니다. 이에 대해서는 Qt Widgets Designer 에 대한 사용자 정의 위젯 만들기 섹션에서 자세히 설명합니다. 확장 팩토리 등록은 일반적으로 QDesignerCustomWidgetInterface::initialize() 함수에서 이루어집니다:

void MyPlugin::initialize(QDesignerFormEditorInterface *formEditor)
{
    if (initialized)
        return;

    QExtensionManager *manager = formEditor->extensionManager();
    Q_ASSERT(manager != 0);

    manager->registerExtensions(new MyExtensionFactory(manager),
                                Q_TYPEID(QDesignerTaskMenuExtension));

    initialized = true;
}

QDesignerCustomWidgetInterface::initialize() 함수의 formEditor 매개 변수는 Qt Widgets Designer 의 현재 QDesignerFormEditorInterface 객체에 대한 포인터입니다. QDesignerFormEditorInterface::extensionManager () 함수를 사용하여 Qt Widgets Designer 의 확장 관리자에 대한 인터페이스를 검색해야 합니다. 그런 다음 QExtensionManager::registerExtensions() 함수를 사용하여 사용자 정의 확장팩토리를 등록합니다.

관련 예제

Qt Widgets Designer 에서 사용자 지정 위젯 확장을 만드는 방법에 대한 자세한 내용은 작업 메뉴 확장 및 컨테이너 확장 예제를 참조하세요.