다음용 컴포넌트 생성 및 사용 Qt Widgets Designer

커스텀 위젯 플러그인 만들기

Qt Widgets Designer 에 대한 사용자 정의 위젯 플러그인을 구현할 때는 QDesignerCustomWidgetInterface 을 서브클래스화하여 Qt Widgets Designer 에 사용자 정의 위젯을 노출해야 합니다. 하나의 사용자 정의 위젯 플러그인은 별도의 라이브러리로 빌드됩니다. 같은 라이브러리에 여러 개의 사용자 정의 위젯 플러그인을 포함하려면 QDesignerCustomWidgetCollectionInterface 을 서브클래싱해야 합니다.

사용자 정의 위젯 플러그인에 Qt Widgets Designer 의 작업 영역 내에서 예상되는 동작과 기능을 제공하려면 관련 확장 클래스를 서브클래싱하면 됩니다:

QDesignerContainerExtension 클래스를 사용하면 사용자 정의 다중 페이지 컨테이너에 페이지를 추가할 수 있습니다. QDesignerTaskMenuExtension 클래스를 사용하면 Qt Widgets Designer 의 작업 메뉴에 사용자 정의 메뉴 항목을 추가할 수 있습니다. QDesignerMemberSheetExtension 클래스를 사용하면 Qt Widgets Designer 의 신호 및 슬롯 편집 모드를 사용하여 연결을 구성할 때 표시되는 위젯의 멤버 함수를 조작할 수 있습니다. 마지막으로 QDesignerPropertySheetExtension 클래스를 사용하면 Qt Widgets Designer 의 속성 편집기에 표시되는 위젯의 속성을 조작할 수 있습니다.

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

확장을 사용하여 사용자 지정 위젯 플러그인을 만드는 전체 예제는 작업 메뉴 확장 또는 컨테이너 확장 예제를 참조하세요.

Qt Widgets Designer 컴포넌트에 대한 액세스 권한 가져오기

이 섹션에서 언급된 클래스의 목적은 Qt Widgets Designer 의 컴포넌트, 관리자 및 작업 공간에 대한 액세스를 제공하기 위한 것이며, 직접 인스턴스화할 수 있는 것은 아닙니다.

Qt Widgets Designer 는 여러 컴포넌트로 구성됩니다. 작업 공간에서 볼 수 있는 액션 에디터, 속성 에디터, 위젯 상자 및 객체 인스펙터가 있습니다.

Qt Widgets Designer 또한 백그라운드에서 작동하는 객체가 있는데, Qt Widgets Designer 의 모든 컴포넌트를 일관된 애플리케이션으로 통합하는 로직이 포함되어 있습니다. QDesignerFormEditorInterface 을 사용하여 이 객체에 액세스하여 Qt Widgets Designer 의 컴포넌트에 대한 인터페이스를 검색할 수 있습니다:

또한 QDesignerFormEditorInterface 을 사용하여 Qt Widgets Designer 의 확장 관리자(QExtensionManager) 및 양식 창 관리자(QDesignerFormWindowManagerInterface)에 대한 인터페이스를 검색할 수 있습니다. 확장 프로그램 관리자는 필요한 확장 프로그램의 구성을 제어하고, 양식 창 관리자는 Qt Widgets Designer 의 작업 영역에 표시되는 양식 창을 제어합니다.

Qt Widgets Designer 의 양식 창 관리자(QDesignerFormWindowManagerInterface)에 대한 인터페이스가 있으면 현재 Qt Widgets Designer 의 작업 영역에 표시되는 모든 양식 창에도 액세스할 수 있습니다: QDesignerFormWindowInterface 클래스는 양식 창을 쿼리하고 조작할 수 있으며 양식 창의 커서에 대한 인터페이스를 제공합니다. QDesignerFormWindowCursorInterface 은 지정된 양식 창의 위젯 선택 항목을 쿼리하고 수정할 수 있는 편의 클래스이며 모든 양식 위젯의 속성을 수정할 수도 있습니다.

런타임에 사용자 인터페이스 만들기

QtDesigner 모듈에는 Qt Widgets Designer 로 생성된 UI 파일을 기반으로 런타임에 사용자 인터페이스를 동적으로 생성하는 메커니즘을 제공하는 QFormBuilder 클래스가 포함되어 있습니다. 이 클래스는 일반적으로 Qt Widgets Designer 을 임베드하는 사용자 정의 컴포넌트 및 애플리케이션에서 사용됩니다. 런타임에 사용자 인터페이스를 동적으로 생성해야 하는 독립 실행형 애플리케이션은 QtUiTools 모듈에 있는 QUiLoader 클래스를 사용합니다.

QUiLoader 을 사용하는 전체 예제는 계산기 빌더 예제를 참조하세요.

Qt Widgets Designer 매뉴얼Qt UI Tools.

© 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.