메인 창 생성 Qt Widgets Designer
Qt Widgets Designer 는 다양한 용도의 사용자 인터페이스를 생성하는 데 사용할 수 있으며, 각 사용자 인터페이스에 맞는 다양한 종류의 양식 템플릿을 제공합니다. 메인 윈도우 템플릿은 메뉴 바, 툴바 및 도크 위젯이 포함된 애플리케이션 윈도우를 생성하는 데 사용됩니다.
파일 메뉴를 열고 ‘새 폼…’ 옵션을 선택하거나 Ctrl+N 키를 눌러 새 메인 창을 만듭니다. 그런 다음 ‘메인 창’ 템플릿을 선택합니다. 이 템플릿은 기본적으로 메뉴 바와 도구 모음이 포함된 메인 애플리케이션 창을 제공하며, 필요하지 않은 경우 이를 제거할 수 있습니다.
메뉴 바를 제거한 경우, 메인 창 폼 내에서 마우스 오른쪽 버튼을 클릭하여 나타나는 컨텍스트 메뉴에서 ‘메뉴 바 만들기’ 옵션을 선택하면 새로운 메뉴 바를 생성할 수 있습니다.
애플리케이션에는 메뉴 바는 하나 만 있을 수 있지만, 툴바는 여러 개를 가질 수 있습니다.
메뉴
메뉴는 ‘Type Here’ 자리 표시자를 수정하여 메뉴 바에 추가됩니다. 이 중 하나는 편집을 위해 항상 표시되며, 미리보기나 완성된 창에는 표시되지 않습니다.
메뉴가 생성되면 속성 편집기를 사용하여 메뉴의 속성에 접근할 수 있으며, 이를 위해 각 메뉴는 객체 검사기를 통해 열 수 있습니다.
기존 메뉴는 메뉴 바의 레이블 위에 마우스를 올려 컨텍스트 메뉴를 열고 ‘메뉴 제거: ‘menu_name’’을 선택하여 제거할 수 있습니다 .

메뉴 생성
편집 시작하려면 자리 표시자 항목을 두 번 클릭하십시오. 라인 편집 상자에 표시된 메뉴 텍스트를 수정할 수 있습니다.
새 메뉴에 필요한 텍스트를 입력합니다. 앰퍼샌드(&) 문자를 입력하면 그 뒤에 오는 문자가 메뉴의 단축키로 사용됩니다.
Return 또는 Enter 키를 눌러 새 텍스트를 적용하거나, Escape 키를 눌러 취소하십시오. 필요한 경우 나중에 편집 작업을 취소할 수 있습니다.
메뉴 바에서 메뉴를 원하는 위치로 드래그 앤 드롭하기만 하면 메뉴의 순서를 재배열할 수도 있습니다. 수직으로 표시된 빨간색 선은 메뉴가 삽입될 위치를 나타냅니다.
메뉴에는 항목과 구분 기호를 원하는 만큼 포함할 수 있으며, 필요한 깊이까지 중첩할 수 있습니다. 메뉴 구조 내에서 일반적인 방식으로 이동하여 메뉴에 새 항목을 추가할 수 있습니다.

메뉴 항목 만들기
'여기에 입력' 자리 표시자를 더블 클릭하여 편집을 시작하거나, '구분선 추가'를 더블 클릭하여 메뉴의 마지막 항목 뒤에 새로운 구분선을 삽입할 수 있습니다.
메뉴 항목의 텍스트는 라인 편집 상자에 표시되며, 수정할 수 있습니다.
새 항목에 필요한 텍스트를 입력하고, 원하는 경우 앰퍼샌드(&) 문자를 사용하여 항목의 약어로 사용할 문자를 지정할 수 있습니다.
Return 또는 Enter 키를 눌러 새 텍스트를 적용하거나, Escape 키를 눌러 취소하십시오. 이 메뉴 항목에 대해 생성된 작업은 작업 편집기를 통해 액세스할 수 있으며, 관련 키보드 단축키는 해당 편집기에서 설정할 수 있습니다.
메뉴와 마찬가지로, 항목을 원하는 위치로 끌어다 놓기만 하면 쉽게 이동할 수 있습니다. 항목을 닫혀 있는 메뉴 위로 끌어다 놓으면 메뉴가 열리며, 해당 위치에 항목을 삽입할 수 있습니다. 메뉴 항목은 동작을 기반으로 하므로 툴바에 끌어다 놓을 수도 있으며, 이 경우 툴바 버튼으로 표시됩니다.
도구 모음

도구 모음 생성 및 제거
도구 모음은 메뉴 모음과 유사한 방식으로 메인 창에 추가됩니다. 폼의 컨텍스트 메뉴에서 '도구 모음 추가' 옵션을 선택하십시오. 또는 메인 창에 기존 도구 모음이 있는 경우, 해당 도구 모음의 오른쪽 끝에 있는 화살표를 클릭하여 새 도구 모음을 만들 수 있습니다.
툴바는 툴바의 컨텍스트 메뉴에 있는 항목을 통해 폼에서 제거할 수 있습니다.
툴바 버튼 추가 및 제거
툴바 버튼은 액션 편집기에서 액션으로 생성된 후 툴바로 드래그하여 추가합니다. 액션은 메뉴 항목과 툴바 버튼으로 표시될 수 있으므로, 메뉴와 툴바 간에 이동할 수 있습니다.

메뉴와 툴바에서 동일한 액션을 공유하려면, 해당 액션이 위치한 메뉴가 아닌 액션 편집기에서 툴바로 아이콘을 드래그하십시오. 이 과정에 대한 자세한 내용은 ‘액션 추가’를 참조하십시오.
툴바 버튼은 툴바의 컨텍스트 메뉴를 통해 제거할 수 있습니다.
작업
메뉴 바와 툴바가 준비되었으니, 이제 여기에 동작을 추가할 차례입니다. 메뉴와 툴바 모두에 대한 새로운 동작은 동작 편집기 창에서 생성되므로, 동작을 만들고 관리하는 과정이 간소화됩니다.

작업 편집기
‘도구’ 메뉴를 열고 ‘작업 편집기’ 옵션을 선택하여 작업 편집기를 활성화합니다.
액션 편집기를 사용하면 새 액션을 생성하거나 액션을 삭제할 수 있습니다. 또한 액션의 텍스트를 기반으로 한 검색 기능인 ‘필터’도 제공합니다.
Qt Widgets Designer이 액션 편집기는 기존 아이콘 보 기와 상세 보기에서 확인할 수 있습니다. 아래 스크린샷은 상세 보기 모드의 액션 편집기를 보여줍니다. 또한 메뉴, 도구 모음 및 양식 간에 액션을 복사하여 붙여 넣을 수도 있습니다.
액션 생성하기
액션을 생성하려면 액션 편집기의 [ 새로 만들기 ] 버튼을 사용하면 입력 대화 상자가 나타납니다. 새 액션에 [ 텍스트 ]를 입력하십시오. 이 텍스트는 메뉴 항목과 액션의 툴팁에 표시됩니다. 또한 이 텍스트는 자동으로 "action" 접두사가 붙어 액션의 객체 이름이 생성됩니다.
또한, 이 대화 상자에서는 액션에 사용할 아이콘을 선택하거나 현재 아이콘을 제거할 수 있는 옵션도 제공합니다.
액션이 생성되면 액션이 적용 가능한 모든 곳에서 사용할 수 있습니다.

작업 추가하기
메뉴나 도구 모음에 액션을 추가하려면, 액션 편집기에서 해당 액션을 마우스 왼쪽 버튼으로 클릭한 채 원하는 위치로 드래그하기만 하면 됩니다.
Qt Widgets Designer 액션이 추가될 위치를 알려주는 강조 표시된 안내선이 나타납니다. 적절한 위치를 찾았다면 마우스 버튼을 놓아 액션을 추가하십시오.
위젯 도킹
도크 위젯도 컨테이너 위젯에 속합니다. 원하는 도크 영역에 드래그하여 놓으면 폼에 추가할 수 있습니다.

도크 위젯 추가하기
폼에 도크 위젯을 추가하려면, 위젯 상자의 ‘컨테이너’ 섹션에서 도크 위젯을 드래그하여 메인 폼 영역에 놓으십시오. 기존 레이아웃에 도크 위젯을 추가하지 마십시오. 대신, 속성 편집기를 열고 ‘도킹됨’ 속성을 활성화하여 도크 영역에 배치하십시오.
레이아웃을 중앙 위젯에 적용하기 전에 폼에 도크 위젯을 추가하는 것이 구성하기 더 쉬운 경우가 있다는 점에 유의하십시오. 예를 들어, 도크에서 분리하고 크기를 조정할 수 있으므로 자식 위젯을 추가하기가 더 편리해집니다.
도크 위젯은 선택적으로 독립적인 도구 창으로 띄울 수 있습니다. 따라서 ' windowTitle ' 속성을 설정하여 창 제목을 지정하는 것이 유용합니다. 이는 또한 폼에서 해당 위젯을 식별하는 데 도움이 됩니다.
© 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.