이 페이지에서

컨테이너 컨트롤

Qt Quick Controls 컨테이너와 유사한 다양한 컨트롤을 제공합니다.

ApplicationWindow

헤더와 푸터를 지원하는 스타일링된 최상위 창

Container

컨테이너에 공통적인 기능을 제공하는 추상 기본 유형

Frame

컨트롤의 논리적 그룹을 위한 시각적 프레임

GroupBox

컨트롤의 논리적 그룹을 위한 시각적 프레임 및 제목

HorizontalHeaderView

TableView와 함께 사용할 수 있는 가로형 헤더 뷰를 제공합니다

Page

헤더와 푸터를 지원하는 스타일링된 페이지 컨트롤

Pane

애플리케이션 스타일 및 테마와 일치하는 배경을 제공합니다

ScrollView

스크롤 가능한 뷰

SplitView

각 항목 사이에 드래그 가능한 스플리터를 배치하여 항목을 배열합니다

StackView

스택 기반의 탐색 모델을 제공합니다

SwipeView

사용자가 옆으로 스와이프하여 페이지를 탐색할 수 있게 합니다

TabBar

사용자가 서로 다른 뷰나 하위 작업 간에 전환할 수 있게 합니다

ToolBar

컨텍스트에 따라 달라지는 컨트롤을 담는 컨테이너

VerticalHeaderView

TableView와 함께 사용할 수 있는 세로형 헤더 뷰를 제공합니다

각 컨테이너 유형은 일련의 컨트롤을 그룹화하는 데 사용할 수 있습니다. 다음 섹션에서는 사용 사례에 따라 적절한 컨테이너 유형을 선택하는 데 필요한 지침을 제공합니다.

ApplicationWindow 컨트롤

메뉴 바, 헤더, 본문 영역, 푸터로 구성된 창 레이아웃

ApplicationWindow 애플리케이션의 루트 윈도우를 생성하며, 해당 윈도우에 선택적 헤더와 푸터를 쉽게 추가할 수 있게 해줍니다.

Frame 컨트롤

'이메일', '캘린더', '연락처'라고 표시된 선택란이 포함된 프레임

Frame 시각적 프레임 내에서 컨트롤의 논리적 그룹을 함께 배치하는 데 사용됩니다.

GroupBox 컨트롤

제목과 테두리가 있는 그룹 상자 내에 체크박스가 포함된 상자

GroupBox 제목이 지정된 시각적 프레임 내에서 논리적인 컨트롤 그룹을 함께 배치하는 데 사용됩니다.

Page 컨트롤

헤더, 콘텐츠 영역, 푸터가 포함된 페이지 와이어프레임

Page 는 페이지별 머리글 및 바닥글 항목을 제공합니다. 머리글과 바닥글을 설정하는 데 ApplicationWindow 를 사용하는 것도 가능하지만, 화면마다 머리글과 바닥글이 달라지는 경우에는 Page 를 사용하는 것이 더 좋습니다.

Pane 컨트롤

배경이 있는 항목이 포함된 패널

Pane 는 애플리케이션 스타일 및 테마와 일치하는 배경색을 제공합니다. 페인(Pane)은 자체적인 레이아웃을 제공하지 않으며, 예를 들어 페이지 컨트롤( RowLayout )이나 페이지 레이아웃 컨트롤( ColumnLayout)을 사용하여 내용을 배치해야 합니다.

ScrollView 컨트롤

스크롤 막대가 있는 스크롤 가능한 콘텐츠 영역을 보여주는 ScrollView 레이아웃

ScrollView 는 사용자 정의 콘텐츠에 대한 스크롤 기능을 제공합니다.

StackView 컨트롤

맨 위 페이지가 보이는 상태로 페이지가 쌓여 있는 모습을 보여주는 스택 뷰 다이어그램

StackView 는 LIFO(마지막에 넣은 항목이 먼저 제거됨) 원리를 사용하여 콘텐츠 페이지를 스택 형태로 구성합니다. 즉, 스택에 마지막으로 "푸시(push)"된 항목이 가장 먼저 제거되며, 최상단 항목이 항상 표시됩니다.

SwipeView 컨트롤

스와이프 가능한 스트립 형태로 배열된 페이지를 보여주는 스와이프 보기 다이어그램

SwipeView 콘텐츠 페이지를 스와이프할 수 있는 스트립 형태로 구성합니다.

TabBar 컨트롤

콘텐츠를 정리하기 위한 여러 탭을 보여주는 탭 바 다이어그램

TabBar 콘텐츠 페이지를 탭 형태로 구성합니다.

ToolBar 컨트롤

도구 버튼이 포함된 도구 모음

ToolBar 애플리케이션 전반에 적용되며 상황에 따라 달라지는 동작과 컨트롤을 포함하는 컨테이너입니다.

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