이 페이지에서

QDesignerFormWindowManagerInterface Class

QDesignerFormWindowManagerInterface 클래스를 사용하면 Qt Widgets Designer 에 있는 폼 창 모음을 조작하고, Qt Widgets Designer 의 폼 편집 동작을 제어할 수 있습니다. 더 보기...

헤더: #include <QDesignerFormWindowManagerInterface>
CMake: find_package(Qt6 REQUIRED COMPONENTS Designer)
target_link_libraries(mytarget PRIVATE Qt6::Designer)
qmake: QT += designer
상속: QObject

공개 타입

enum Action { CutAction, CopyAction, PasteAction, DeleteAction, SelectAllAction, …, FormWindowSettingsDialogAction }
enum ActionGroup { StyledPreviewActionGroup }

공개 함수

QDesignerFormWindowManagerInterface(QObject *parent = nullptr)
virtual ~QDesignerFormWindowManagerInterface() override
virtual QAction *action(QDesignerFormWindowManagerInterface::Action action) const = 0
virtual QActionGroup *actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const = 0
virtual QDesignerFormWindowInterface *activeFormWindow() const = 0
virtual QDesignerFormEditorInterface *core() const = 0
virtual QDesignerFormWindowInterface *createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) = 0
virtual QPixmap createPreviewPixmap() const = 0
virtual QDesignerFormWindowInterface *formWindow(int index) const = 0
virtual int formWindowCount() const = 0

공개 슬롯

virtual void addFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void closeAllPreviews() = 0
virtual void removeFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void setActiveFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void showPluginDialog() = 0
virtual void showPreview() = 0

신호

void activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
void formWindowAdded(QDesignerFormWindowInterface *formWindow)
void formWindowRemoved(QDesignerFormWindowInterface *formWindow)
void formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)

상세 설명

QDesignerFormWindowManagerInterface는 직접 인스턴스화되도록 의도되지 않았습니다. Qt Widgets Designer 는 폼 윈도우 관리자를 사용하여 작업 공간 내의 다양한 폼 윈도우를 제어합니다. QDesignerFormEditorInterface::formWindowManager() 함수를 사용하여 Qt Widgets Designer 의 폼 윈도우 관리자에 대한 인터페이스를 가져올 수 있습니다. 예를 들어:

        auto *manager = formEditor->formWindowManager();
        auto *formWindow = manager->formWindow(0);

        manager->setActiveFormWindow(formWindow);

사용자 정의 위젯 플러그인을 구현할 때, Qt Widgets Designer 의 현재 QDesignerFormEditorInterface 객체(위 예제에서는formEditor )에 대한 포인터는 QDesignerCustomWidgetInterface::initialize() 함수의 매개변수를 통해 제공됩니다. 플러그인을 Qt Widgets Designer 에 노출시키려면 QDesignerCustomWidgetInterface 를 상속받은 서브클래스를 만들어야 합니다.

폼 창 관리자 인터페이스는 createFormWindow() 함수를 제공하며, 이를 통해 새로운 폼 창을 생성할 수 있습니다. 생성된 폼 창은 addFormWindow() 슬롯을 사용하여 관리자가 유지하는 폼 창 모음에 추가할 수 있습니다. 또한, 관리자가 현재 제어하고 있는 폼 윈도우의 수를 반환하는 formWindowCount() 함수, 주어진 인덱스와 연관된 폼 윈도우를 반환하는 formWindow() 함수, 현재 선택된 폼 윈도우를 반환하는 activeFormWindow() 함수도 제공합니다. removeFormWindow() 슬롯을 사용하면 관리자가 유지 관리해야 하는 폼 창 수를 줄일 수 있으며, setActiveFormWindow() 슬롯을 사용하면 Qt Widgets Designer 의 작업 공간에서 폼 창의 포커스를 변경할 수 있습니다.

또한, QDesignerFormWindowManagerInterface에는 Qt Widgets Designer 의 양식 편집 동작에 개입하고 제어할 수 있게 해주는 일련의 함수들이 포함되어 있습니다. 이 모든 함수는 원래의 동작을 반환하므로, 개입 후에도 함수를 추가로 전달할 수 있습니다.

마지막으로, 이 인터페이스는 폼 창이 추가될 때, 현재 선택된 폼 창이 변경될 때, 또는 폼 창이 제거될 때 각각 발생되는 세 가지 신호를 제공합니다. 모든 신호는 해당 폼 창을 매개변수로 전달합니다.

QDesignerFormEditorInterface 및 QDesignerFormWindowInterface도 참조하십시오 .

멤버 유형 문서

enum QDesignerFormWindowManagerInterface::Action

Qt Widgets Designer 의 동작을 지정합니다.

상수값설명
QDesignerFormWindowManagerInterface::CutAction100클립보드 잘라내기
QDesignerFormWindowManagerInterface::CopyAction101클립보드 잘라내기
QDesignerFormWindowManagerInterface::PasteAction102클립보드에 붙여넣기클립보드 삭제
QDesignerFormWindowManagerInterface::DeleteAction103클립보드 삭제
QDesignerFormWindowManagerInterface::SelectAllAction104전체 선택
QDesignerFormWindowManagerInterface::LowerAction200현재 위젯 아래로 내리기
QDesignerFormWindowManagerInterface::RaiseAction201현재 위젯 위로 올리기
QDesignerFormWindowManagerInterface::UndoAction300실행 취소
QDesignerFormWindowManagerInterface::RedoAction301다시 실행
QDesignerFormWindowManagerInterface::HorizontalLayoutAction400다음으로 레이아웃 설정 QHBoxLayout
QDesignerFormWindowManagerInterface::VerticalLayoutAction401다음으로 레이아웃 지정 QVBoxLayout
QDesignerFormWindowManagerInterface::SplitHorizontalAction402가로 방향으로 배치 QSplitter
QDesignerFormWindowManagerInterface::SplitVerticalAction403세로로 배치 QSplitter
QDesignerFormWindowManagerInterface::GridLayoutAction404다음으로 레이아웃하기 QGridLayout
QDesignerFormWindowManagerInterface::FormLayoutAction405다음으로 레이아웃 구성 QFormLayout
QDesignerFormWindowManagerInterface::BreakLayoutAction406기존 레이아웃 분리
QDesignerFormWindowManagerInterface::AdjustSizeAction407크기 조정
QDesignerFormWindowManagerInterface::SimplifyLayoutAction408QGridLayout 를 단순화하거나 QFormLayout
QDesignerFormWindowManagerInterface::DefaultPreviewAction500기본 스타일로 미리 보기 생성
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction600양식 설정이 포함된 대화 상자 표시

action()도 참조하십시오 .

enum QDesignerFormWindowManagerInterface::ActionGroup

Qt Widgets Designer 의 액션 그룹을 지정합니다.

상수값설명
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup100스타일이 적용된 미리 보기 동작이 포함된 동작 그룹

actionGroup()도 참조하십시오 .

멤버 함수 문서

[explicit] QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)

지정된 parent 를 사용하여 폼 창 관리자를 위한 인터페이스를 생성합니다.

[override virtual noexcept] QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()

폼 윈도우 관리자의 인터페이스를 제거합니다.

[pure virtual] QAction *QDesignerFormWindowManagerInterface::action(QDesignerFormWindowManagerInterface::Action action) const

action 열거형 값으로 지정된 액션을 반환합니다.

Qt 4.X의 액션 액세서리를 더 이상 사용하지 않게 됩니다.

[pure virtual] QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const

actionGroup 열거형 값으로 지정된 액션 그룹을 반환합니다.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const

Qt Widgets Designer 의 작업 공간에서 현재 활성화된 양식 창을 반환합니다.

setActiveFormWindow() 및 removeFormWindow()도 참조하십시오 .

[signal] void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)

이 신호는 Qt Widgets Designer 의 작업 공간에서 현재 활성화된 폼 창의 내용이 변경되었을 때 발생합니다. 현재 활성화된 formWindow 에 대한 포인터가 인자로 전달됩니다.

activeFormWindow()도 참조하십시오 .

[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)

지정된 formWindow 를 Qt Widgets Designer 의 폼 윈도우 관리자가 관리하는 윈도우 모음에 추가합니다.

formWindowAdded()도 참조하십시오 .

[pure virtual slot] void QDesignerFormWindowManagerInterface::closeAllPreviews()

현재 열려 있는 모든 미리보기를 닫습니다.

showPreview()도 참조하십시오 .

[pure virtual] QDesignerFormEditorInterface *QDesignerFormWindowManagerInterface::core() const

Qt Widgets Designer 의 현재 QDesignerFormEditorInterface 객체에 대한 포인터를 반환합니다.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

지정된 parent 와 지정된 창 flags 을 사용하여 양식 창을 생성합니다.

addFormWindow()도 참조하십시오 .

[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const

현재 활성화된 양식의 미리보기를 나타내는 픽스맵을 생성합니다.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const

지정된 index 에 있는 양식 창을 반환합니다.

setActiveFormWindow() 및 removeFormWindow()도 참조하십시오 .

[signal] void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)

이 신호는 Qt Widgets Designer 의 폼 창 관리자가 관리하는 창 모음에 새로운 폼 창이 추가될 때 발생합니다. 새로운 formWindow 에 대한 포인터가 인자로 전달됩니다.

addFormWindow() 및 setActiveFormWindow()도 참조하십시오 .

[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const

Qt Widgets Designer 의 폼 창 관리자가 관리하는 폼 창의 개수를 반환합니다.

[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)

이 신호는 Qt Widgets Designer 의 폼 창 관리자가 관리하는 창 모음에서 폼 창이 제거될 때 발생합니다. 제거된 formWindow 에 대한 포인터가 인자로 전달됩니다.

removeFormWindow()도 참조하십시오 .

[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)

이 신호는 폼 창의 설정이 변경될 때 발생합니다. 이를 활용하여 창 제목 등을 그에 맞게 업데이트할 수 있습니다. 인자로 ` formWindow `에 대한 포인터가 전달됩니다.

FormWindowSettingsDialogAction도 참조하십시오 .

[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)

Qt Widgets Designer 의 폼 윈도우 관리자가 관리하는 윈도우 모음에서 지정된 formWindow 를 제거합니다.

formWindow() 및 formWindowRemoved()도 참조하십시오 .

[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)

지정된 formWindow 을 Qt Widgets Designer 의 작업 공간에서 현재 활성화된 양식 창으로 설정합니다.

activeFormWindow() 및 activeFormWindowChanged()도 참조하십시오 .

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPluginDialog()

Qt Widgets Designer 에서 로드된 플러그인과 플러그인 로드 실패 내역을 보여주는 대화 상자를 엽니다.

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPreview()

기본 매개변수를 사용하여 현재 양식의 미리보기를 표시합니다.

closeAllPreviews()도 참조하십시오 .

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