레이아웃 사용 Qt Widgets Designer
양식을 사용하기 전에 양식상의 개체를 레이아웃에 배치해야 합니다. 이렇게 하면 양식을 미리 보거나 애플리케이션에서 사용할 때 개체가 올바르게 표시됩니다. 또한 개체를 레이아웃에 배치하면 양식의 크기가 조정될 때 개체의 크기도 올바르게 조정됩니다.
위젯이 레이아웃에 삽입되면, 레이아웃 자체가 스페이서가 제공하는 힌트를 고려하여 그 안의 각 위젯의 기하학적 속성을 제어하기 때문에 위젯을 개별적으로 이동하거나 크기를 조정할 수 없습니다. 위젯의 기하학적 속성에 영향을 주기 위해 레이아웃에 스페이서를 추가할 수 있습니다.
레이아웃은 중첩하여 계층 구조를 형성할 수 있습니다. 예를 들어, 버튼이 수평으로 배열된 일반적인 대화 상자 레이아웃을 구현하려면, 대화 상자 요소를 수직 박스 레이아웃으로 배치하고, 그 하단에 버튼을 포함하는 수평 박스 레이아웃을 사용할 수 있습니다. Qt 레이아웃 시스템에 대한 소개는 레이아웃 관리 문서를 참조하십시오.
레이아웃을 분할하려면 Ctrl+0을 누르거나, 폼의 컨텍스트 메뉴, 폼 메뉴 또는 메인 툴바에서 ‘레이아웃 분할(Break Layout)’을 선택하십시오.
최상위 레이아웃 설정
폼의 최상위 레이아웃은 선택을 해제(폼 자체를 마우스 왼쪽 버튼으로 클릭)한 후 레이아웃을 적용하여 설정할 수 있습니다. 최상위 레이아웃은 창 크기가 조정될 때 위젯의 크기도 올바르게 조정되도록 하기 위해 필요합니다. 최상위 레이아웃이 설정되었는지 확인하려면 위젯을 미리 보고 크기 조절 손잡이를 드래그하여 창 크기를 조정해 보십시오.
![]() | 레이아웃 적용 레이아웃을 적용하려면 왼쪽에 표시된 도구 모음이나 아래에 표시된 컨텍스트 메뉴에서 원하는 레이아웃을 선택할 수 있습니다. |
마찬가지로, 최상위 레이아웃은 컨테이너 위젯(QGroupBox)이나 페이지 기반 컨테이너 위젯(QTabWidget, QToolBox 및 QStackedWidget)의 페이지에 각각 설정됩니다. 이 작업이 성공하려면 해당 컨테이너 위젯을 선택해야 합니다.
최상위 레이아웃은 객체 검사기(Object Inspector)에서 별도의 객체로 표시되지 않습니다. 해당 속성은 속성 편집기(Property Editor)에서 메인 폼, 컨테이너 위젯 또는 컨테이너 위젯의 페이지에 대한 위젯 속성 아래에 표시됩니다.

레이아웃 객체
레이아웃 객체는 기존 객체 그룹에 레이아웃을 적용하여 생성됩니다. 이를 위해서는 관리할 객체를 선택한 다음, 메인 툴바, ‘폼(Form )’ 메뉴 또는 폼의 컨텍스트 메뉴를 사용하여 표준 레이아웃 중 하나를 적용하면 됩니다.
레이아웃 객체는 폼에서 빨간색 테두리로 표시되며, 객체 인스펙터에 객체로 나타납니다. 이 객체의 속성(여백 및 제약 조건)은 속성 편집기에 표시됩니다.
레이아웃 개체를 선택하여 다른 위젯 및 레이아웃 개체와 함께 다른 레이아웃 내에 배치함으로써 레이아웃 계층 구조를 구축할 수 있습니다.
자식 레이아웃 객체를 선택한 상태에서 Shift 키를 누른 채 해당 객체를 클릭하면 부모 레이아웃 객체를 선택할 수 있습니다. 이를 통해 계층 구조 내에서 특정 레이아웃을 선택할 수 있는데, 프레임 크기가 작아 그렇지 않으면 선택하기 어렵기 때문입니다.
레이아웃에 객체 삽입하기
오브젝트를 현재 위치에서 드래그하여 원하는 위치에 놓으면 기존 레이아웃에 삽입할 수 있습니다. 오브젝트를 레이아웃 위로 드래그하면 오브젝트가 추가될 위치를 나타내는 파란색 커서가 레이아웃에 표시됩니다.

레이아웃에 개체 삽입하기
레이아웃 유형
가로 및 세로(박스) 레이아웃
폼에 개체를 배치하는 가장 간단한 방법은 가로 또는 세로 레이아웃에 개체를 배치하는 것입니다. 가로 레이아웃을 사용하면 레이아웃 내의 위젯이 가로로 정렬되고, 세로 레이아웃을 사용하면 세로로 정렬됩니다.
가로 및 세로 레이아웃은 결합하거나 원하는 깊이까지 중첩할 수 있습니다. 그러나 개체의 배치에 대해 더 세밀한 제어가 필요한 경우, 그리드 레이아웃을 사용하는 것을 고려해 보십시오.
그리드 레이아웃
그리드 레이아웃에 개체를 배치하면 복잡한 양식 레이아웃을 만들 수 있습니다. 이러한 레이아웃은 양식 설계자가 양식 내 위젯을 배치할 때 훨씬 더 큰 자유를 제공하지만, 결과적으로 레이아웃의 유연성이 크게 떨어질 수 있습니다. 하지만 일부 양식 레이아웃의 경우, 수평 및 수직 레이아웃을 중첩하여 배치하는 것보다 그리드 배치가 훨씬 더 적합할 수 있습니다.
양식 레이아웃
QFormLayout 클래스는 2열 양식의 위젯을 관리합니다. 왼쪽 열에는 레이블이, 오른쪽 열에는 라인 편집기, 스핀 박스 등과 같은 필드 위젯이 배치됩니다. QFormLayout 클래스는 다양한 플랫폼의 룩앤필 지침을 준수하며, 긴 행에 대한 줄 바꿈을 지원합니다.

위의 UI 파일을 적용하면 아래와 같은 미리보기가 표시됩니다.
| Windows | macOS | Cleanlooks |
|---|---|---|
![]() | ![]() | ![]() |
분할 화면 레이아웃
폼에서 객체의 레이아웃을 관리하는 또 다른 일반적인 방법은 객체를 스플리터에 배치하는 것입니다. 이러한 스플리터는 일반 레이아웃과 마찬가지로 객체를 수평 또는 수직으로 배열하지만, 사용자가 각 객체에 할당된 공간의 크기를 조정할 수도 있게 해줍니다.

QSplitter 는 컨테이너 위젯이지만, Qt Widgets Designer 에서는 스플리터 객체를 기존 위젯에 적용되는 레이아웃으로 취급합니다. 위젯 그룹을 스플리터에 배치하려면, 여기에서 설명한 대로 위젯을 선택한 다음 적절한 도구 모음 버튼, 키보드 단축키 또는 ‘레이아웃(Lay out) ’ 컨텍스트 메뉴 항목을 사용하여 스플리터 레이아웃을 적용하십시오.
단축키
표준 도구 모음 및 컨텍스트 메뉴 항목 외에도, 위젯에 레이아웃을 적용하는 데 사용할 수 있는 일련의 키보드 단축키가 있습니다.
| 레이아웃 | 단축키 | 설명 |
|---|---|---|
| 가로 | Ctrl+1 | 선택한 개체를 가로 레이아웃으로 배치합니다. |
| 세로 | Ctrl+2 | 선택한 개체를 세로 레이아웃으로 배치합니다. |
| 격자 | Ctrl+5 | 선택한 개체를 격자 레이아웃으로 배치합니다. |
| 양식 | Ctrl+6 | 선택한 개체를 양식 레이아웃으로 배치합니다. |
| 가로 분할선 | Ctrl+3 | 가로 분할선을 생성하고 선택한 개체를 그 안에 배치합니다. |
| 수직 분할선 | Ctrl+4 | 수직 분할선을 생성하고 선택한 개체를 그 안에 배치합니다. |
| 크기 조정 | Ctrl+J | 각 하위 개체가 내용을 표시할 수 있는 충분한 공간을 확보할 수 있도록 레이아웃의 크기를 조정합니다. 자세한 내용은 QWidget::adjustSize()을 참조하십시오. |
참고: Ctrl+0은 레이아웃을 분할하는 데 사용됩니다.
© 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.



