이 페이지에서

Qt Widgets Designer의 위젯 편집 모드

레이아웃 내 구성 요소의 크기와 위치를 변경하기 위한 Qt Widgets Designer 편집 모드를 보여주는 스크린샷

위젯 편집 모드에서는 메인 창의 위젯 상자에서 폼으로 객체를 드래그하여 가져올 수 있으며, 편집, 크기 조정, 폼 내 이동은 물론 폼 간 이동도 가능합니다. 객체 속성을 대화형으로 수정할 수 있어 변경 사항이 즉시 반영됩니다. 이 편집 인터페이스는 간단한 작업에 있어 직관적이면서도 Qt의 강력한 레이아웃 기능을 지원합니다.

새 폼을 생성하거나 편집하려면 파일 메뉴에서 ‘새 폼...’을 선택하거나 Ctrl+N을 누르십시오. 기존 폼은 파일 메뉴에서 ‘폼 열기...’를 선택하거나 Ctrl+O를 눌러 편집할 수도 있습니다.

언제든지 파일 메뉴에서 ‘다른 이름으로 저장...’ 옵션을 선택하여 폼을 저장할 수 있습니다. Qt Widgets Designer 로 저장된 UI 파일에는 사용된 객체에 대한 정보와 객체 간의 신호 및 슬롯 연결에 대한 세부 정보가 포함됩니다.

폼 편집하기

기본적으로 새 양식은 위젯 편집 모드로 열립니다. 다른 모드에서 편집 모드로 전환하려면 편집 메뉴에서 ‘위젯 편집’을 선택하거나 F3 키를 누르십시오.

개체는 메인 위젯 상자에서 드래그하여 양식의 원하는 위치에 놓으면 양식에 추가됩니다. 추가된 개체는 드래그하거나 방향 키를 사용하여 쉽게 이동할 수 있습니다. Ctrl 키를 함께 누르면 선택한 위젯이 픽셀 단위로 이동하며, 커서 키만 사용하면 선택한 위젯이 이동 시 격자에 정렬됩니다. 개체는 마우스 왼쪽 버튼으로 클릭하여 선택할 수 있습니다. Tab 키를 사용하여 선택 대상을 변경할 수도 있습니다.

위젯 상자에는 다양한 범주의 객체가 포함되어 있으며, 이 모든 객체는 필요에 따라 폼에 배치할 수 있습니다. 약간 더 많은 준비가 필요한 유일한 객체는 컨테이너 위젯입니다. 이에 대한 자세한 내용은 ‘ Qt Widgets Designer 에서 컨테이너 사용하기’ 장에서 설명합니다.

Qt Widgets Designer의 편집기 모드에서 선택된 위젯을 보여주는 스크린샷개체 선택

양식상의 개체는 마우스 왼쪽 버튼으로 클릭하여 선택할 수 있습니다. 개체가 선택되면 각 모서리와 각 변의 중간 지점에 크기 조정 핸들이 표시되며, 이는 크기를 조정할 수 있음을 나타냅니다.

다른 개체를 추가로 선택하려면 Control 키를 누른 상태에서 해당 개체를 클릭하십시오. 두 개 이상의 개체가 선택된 경우, 현재 선택된 개체는 다른 색상의 크기 조정 핸들이 표시됩니다.

레이아웃 내에서 위젯을 이동하려면 Shift 키 와 Control 키를 누른 상태에서 위젯을 드래그하십시오. 이렇게 하면 선택 범위가 위젯의 상위 레이아웃까지 확장됩니다.

또는 ‘객체 검사기’에서 객체를 선택할 수도 있습니다.

위젯이 선택되면 잘라내기, 복사, 붙여넣기 등 일반적인 클립보드 작업을 수행할 수 있습니다. 이러한 모든 작업은 필요에 따라 실행하거나 취소할 수 있습니다.

다음과 같은 단축키를 사용할 수 있습니다:

작업단축키설명
잘라내기Ctrl+X선택한 개체를 잘라내어 클립보드에 복사합니다.
복사Ctrl+C선택한 개체를 클립보드에 복사합니다.
붙여넣기Ctrl+V클립보드에 있는 개체를 양식에 붙여넣습니다.
삭제삭제삭제선택한 개체를 삭제합니다.
개체 복제Ctrl+드래그 (마우스 왼쪽 버튼)선택한 개체 또는 개체 그룹의 복사본을 만듭니다.
미리 보기Ctrl+R폼의 미리보기를 표시합니다.

(복제를 제외한) 위의 모든 작업은 '편집' 메뉴와 폼의 컨텍스트 메뉴를 통해 모두 이용할 수 있습니다. 또한 이 메뉴들에는 개체를 배치하는 기능과 폼에 있는 모든 개체를 선택하는 '모두 선택' 기능도 제공됩니다.

위젯은 고유한 객체가 아니므로, 필요에 따라 원하는 만큼 복사할 수 있습니다. 위젯을 빠르게 복제하려면 Ctrl 키를 누른 상태에서 위젯을 드래그하여 복제할 수 있습니다. 이렇게 하면 클립보드 작업을 사용하는 것보다 더 빠르게 위젯을 복사하여 양식에 배치할 수 있습니다.

드래그 앤 드롭을 통해 자유롭게 이동할 수 있는 UI 편집기의 위젯을 보여주는 스크린샷드래그 앤 드롭

Qt Widgets Designer 는 Qt에서 제공하는 드래그 앤 드롭 기능을 폭넓게 활용합니다. Qt Widgets를 위젯 상자에서 끌어와 폼 위에 놓을 수 있습니다.

위젯은 폼에서 "복제"할 수도 있습니다. Ctrl 키를 누른 상태에서 위젯을 드래그하면 위젯의 복사본이 생성되며, 이 복사본을 새로운 위치로 드래그할 수 있습니다.

또한 위젯을 객체 인스펙터 에 놓아 중첩된 레이아웃을 쉽게 처리할 수도 있습니다.

Qt Widgets Designer 이 기능을 사용하면 선택한 객체를 복사, 붙여넣기하거나 폼 간에 드래그할 수 있습니다. 이 기능을 활용하여 동일한 폼의 복사본을 여러 개 생성하고, 각 복사본에서 서로 다른 레이아웃을 실험해 볼 수 있습니다.

속성 편집기

속성 편집기는 항상 폼에서 현재 선택된 객체의 속성을 표시합니다. 사용 가능한 속성은 편집 중인 객체에 따라 다르지만, 제공되는 모든 위젯에는 ` objectName`(객체의 내부 이름) 및 ` enabled`(객체와 상호작용할 수 있는지 여부를 결정하는 속성)와 같은 공통 속성이 있습니다.

원하는 대로 위젯을 자유롭게 변경할 수 있는 옵션이 포함된 위젯의 속성 편집기를 보여주는 스크린샷속성 편집

속성 편집기는 표준 Qt Widgets를 사용하여 폼상의 객체 속성을 관리합니다. 텍스트 속성은 라인 에디트에, 정수 속성은 스핀박스에, 부울 속성은 체크박스에 표시되며, 색상이나 크기 같은 복합 속성은 입력 위젯의 드롭다운 목록에 표시됩니다.

수정된 속성은 굵은 글씨로 표시됩니다. 속성을 초기화하려면 오른쪽의 화살표 버튼을 클릭하십시오.

속성 변경 사항은 동일한 속성을 가진 모든 선택된 객체에 적용됩니다.

특정 속성은 속성 편집기에서 특별히 처리됩니다:

  • 복합 속성(하나 이상의 값으로 구성된 속성)은 확장 가능한 노드로 표시되며, 이를 통해 해당 값을 편집할 수 있습니다.
  • 플래그 선택 항목이 포함된 속성은 체크 가능한 항목이 있는 콤보 박스를 통해 편집됩니다.
  • QPalette 와 같은 풍부한 데이터 유형에 접근할 수 있는 속성은, 해당 속성을 편집할 때 열리는 대화 상자를 사용하여 수정됩니다. QLabel 및 위젯 상자의 ‘버튼 ( Buttons )’ 섹션에 있는 위젯들은 ‘ text ’ 속성을 가지고 있으며, 이 속성은 위젯을 더블 클릭하거나 F2 키를 눌러 편집할 수도 있습니다. Qt Widgets Designer 백슬래시(\) 문자를 특수하게 해석하여 텍스트에 줄바꿈(\n) 문자를 삽입할 수 있게 합니다. \\ 문자 시퀀스는 텍스트에 백슬래시 하나를 삽입하는 데 사용됩니다. 편집 중에 컨텍스트 메뉴를 열 수도 있으며, 이를 통해 텍스트에 특수 문자와 줄바꿈을 삽입하는 또 다른 방법을 이용할 수 있습니다.

동적 속성

속성 편집기를 사용하면 표준 Qt Widgets와 폼 자체 모두에 새로운 속성( dynamic properties )을 추가할 수도 있습니다. Qt 4.4부터는 아래에 표시된 속성 편집기의 도구 모음을 통해 동적 속성을 추가하거나 제거할 수 있습니다.

위젯의 속성 편집기 도구 모음을 보여주는 스크린샷

동적 속성을 추가하려면 [ 추가 ] 버튼 추가 버튼 을 클릭하십시오. 제거하려면 [ 제거 ] 버튼 제거 버튼 을 클릭하십시오. 또한 [ 구성 ] 버튼 ‘구성’ 버튼 을 클릭하여 속성을 알파벳 순으로 정렬하거나 색상 그룹을 변경할 수 있습니다.

객체 검사기

레이아웃에 포함된 모든 위젯의 객체 트리를 보여주는 스크린샷객체 검사기

객체 인스펙터는 현재 편집 중인 양식에 있는 모든 객체의 계층적 목록을 표시합니다. 컨테이너 위젯이나 레이아웃의 자식 객체를 보려면 객체 레이블 옆에 있는 핸들을 클릭하십시오.

폼에 있는 각 객체는 객체 인스펙터에서 해당 항목을 클릭하여 선택할 수 있습니다. 마우스 오른쪽 버튼을 클릭하면 폼의 컨텍스트 메뉴가 열립니다. 이러한 기능은 겹쳐진 객체가 많은 경우에 유용합니다. 객체 인스펙터에서 특정 객체를 찾으려면 Ctrl+F를 사용하십시오.

Qt 4.4부터는 객체 이름을 더블 클릭하면 인플레이스 편집기를 통해 객체 이름을 변경할 수 있습니다.

Qt 4.5부터는 객체 인스펙터에 컨테이너의 레이아웃 상태가 표시됩니다. 레이아웃에 문제가 있는 경우 깨진 레이아웃 아이콘 ###ICON이 표시됩니다.

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