컨테이너 사용 Qt Widgets Designer

컨테이너 위젯은 양식 내의 개체 그룹을 고수준으로 제어할 수 있게 해줍니다. 이 위젯을 사용하면 입력 위젯 관리, 페이지별 및 탭 기반 레이아웃 제공, 또는 단순히 다른 개체를 위한 장식용 컨테이너 역할 수행 등 다양한 기능을 수행할 수 있습니다.

Qt Widgets Designer 컨테이너 내부에 객체를 배치하는 데 도움이 되는 시각적 피드백을 제공합니다. 폼의 위젯 상자(또는 다른 위치)에서 객체를 드래그할 때, 커서가 컨테이너 위로 이동하면 해당 컨테이너가 강조 표시됩니다. 이는 해당 객체를 컨테이너 내부에 드롭하여 컨테이너의 자식 객체로 만들 수 있음을 나타냅니다. 객체를 컨테이너 내부에 실제로 배치하지 않고 단순히 근처에 두기 쉬우므로, 이러한 시각적 피드백은 중요합니다. 컨테이너 내부에는 위젯과 스페이서를 모두 사용할 수 있습니다.

Qt Widgets Designer 에서는 중첩 위젯, 탭 위젯 및 툴박스가 특별히 처리됩니다. 일반적으로 사용자 정의 코드에서 이러한 컨테이너에 페이지(탭, 페이지, 구획)를 추가할 때는, 자리 표시자로 사용하거나 자식 위젯을 포함하는 기존 위젯을 제공해야 합니다. Qt Widgets Designer 에서는 이러한 요소들이 자동으로 생성되므로, 각 페이지에 자식 객체를 바로 추가할 수 있습니다.

일반적으로 각 컨테이너는 자식 객체들을 하나 이상의 레이아웃으로 배열할 수 있도록 허용합니다. 제공되는 레이아웃 관리 방식은 각 컨테이너에 따라 다르지만, 레이아웃을 설정하는 것은 대개 컨테이너를 클릭하여 선택한 다음 레이아웃을 적용하는 것만으로 충분합니다. 아래 표는 사용 가능한 컨테이너 목록을 보여줍니다.

	프레임 프레임은 위젯을 둘러싸고 그룹화할 뿐만 아니라 장식용으로도 사용됩니다. 프레임은 더 복잡한 컨테이너의 기초로 사용되지만, 양식에서 자리 표시자로도 사용할 수 있습니다. 프레임의 가장 중요한 속성은 ` `frameShape``, ` `frameShadow``, ` `lineWidth``, ` `midLineWidth``입니다. 이 속성들에 대한 자세한 설명은 ` QFrame ` 클래스 설명에서 확인할 수 있습니다.
	그룹 박스 그룹 박스는 일반적으로 유사한 용도를 가진 체크박스 및 라디오 버튼 모음을 한데 묶는 데 사용됩니다. 그룹 박스의 주요 속성으로는 `title`, `flat`, `checkable` 및 `checked` 등이 있으며, 이에 대한 자세한 내용은 QGroupBox 클래스 설명에서 확인할 수 있습니다. 각 그룹 박스는 고유한 레이아웃을 가질 수 있으며, 다른 위젯을 포함하는 경우 이는 필수적입니다. 그룹 박스에 레이아웃을 추가하려면 그룹 박스 내부를 클릭한 후 평소와 같이 레이아웃을 적용하면 됩니다.
	겹쳐진 위젯 겹쳐진 위젯은 가장 상단의 레이어만 표시되는 위젯 모음입니다. 표시되는 레이어에 대한 제어는 일반적으로 콤보박스 같은 다른 위젯이 신호와 슬롯을 사용하여 관리합니다. Qt Widgets Designer 디자인 시 스택 내의 모든 위젯을 볼 수 있도록 스택의 오른쪽 상단 모서리에 화살표가 표시됩니다. 이 화살표는 미리보기나 최종 컴포넌트에서는 나타나지 않습니다. 스택 내의 페이지 간을 이동하려면 스택형 위젯을 선택한 후 컨텍스트 메뉴의 ‘다음 페이지’ 및 ‘이전 페이지’ 항목을 사용하십시오. 컨텍스트 메뉴의 ‘페이지 삽입’ 및 ‘페이지 삭제’ 옵션을 사용하면 페이지를 추가하거나 제거할 수 있습니다.
	탭 위젯 탭 위젯을 사용하면 개발자가 위젯의 내용을 서로 다른 레이블이 지정된 섹션으로 나눌 수 있으며, 한 번에 하나의 섹션만 표시됩니다. 기본적으로 탭 위젯에는 두 개의 탭이 포함되어 있으며, 필요에 따라 이를 삭제하거나 이름을 변경할 수 있습니다. 또한 탭을 추가로 생성할 수도 있습니다. 탭을 삭제하려면: 해당 탭의 레이블을 클릭하여 현재 탭으로 설정합니다. 탭 위젯을 선택하고 컨텍스트 메뉴를 엽니다. '페이지 삭제'를 선택합니다. 새 탭을 추가하려면: 탭 위젯을 선택하고 컨텍스트 메뉴를 엽니다. '페이지 삽입'을 선택합니다. 현재 페이지 앞이나 뒤에 페이지를 추가할 수 있습니다. ‘ Qt Widgets Designer ’을 선택하면 해당 탭에 대한 새 위젯이 생성되어 탭 위젯에 삽입됩니다. 속성 편집기에서 ‘ `currentTabText` ’ 속성을 변경하여 현재 탭의 제목을 설정할 수 있습니다.
	ToolBox 위젯 Toolbox 위젯은 도구 상자 내에 일련의 페이지 또는 구획을 제공합니다. 이 위젯들은 스택형 위젯과 유사한 방식으로 처리됩니다. 툴박스 내 페이지의 이름을 변경하려면, 툴박스를 현재 페이지로 설정한 다음 속성 편집기에서 해당 페이지의 ` `currentItemText` ` 속성을 변경하십시오. 새 페이지를 추가하려면 툴박스 위젯의 컨텍스트 메뉴에서 [ 페이지 삽입(Insert Page )]을 선택하십시오. 현재 페이지 앞이나 뒤에 페이지를 추가할 수 있습니다. 페이지를 삭제하려면 툴박스 위젯의 컨텍스트 메뉴에서 ‘페이지 삭제(Delete Page )’를 선택하십시오.
	도크 위젯 도킹 위젯은 입력 위젯이나 더 복잡한 컨트롤을 포함하는 경우가 많은 플로팅 패널로, 메인 창의 가장자리에 있는 “도킹 영역”에 고정되거나 독립적인 도구 창으로 떠 있을 수 있습니다. 도킹 위젯은 모든 유형의 폼에 추가할 수 있지만, 일반적으로 메인 윈도우 템플릿으로 생성된 폼에서 사용됩니다.

양식 저장, 미리 보기 및 인쇄 메인 창 만들기

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