이 페이지에서

Qt Quick Templates 2 QML Types

Qt Quick 의 Templates 2 모듈은 QML에서 사용자 인터페이스 컨트롤을 구축하는 데 사용할 수 있는 일련의 비시각적 템플릿을 제공하며, 이를 통해 Qt Quick.

이러한 유형은 기존 컨트롤을 사용자 정의하는 대신, 컨트롤을 처음부터 구현하고자 할 때 사용해야 합니다. 이는 주로 사용자 정의 스타일을 생성할 때 해당됩니다.

.qml 파일에서 다음 import 문을 사용하여 QML 타입을 가져올 수 있습니다:

import QtQuick.Templates as T

QtQuick.Templates 및 QtQuick.Controls 임포트에서 제공하는 유형 간에는 일대일 대응 관계가 있습니다. QtQuick.Controls 임포트에서 사용할 수 있는 모든 유형에 대해, QtQuick.Templates 임포트에는 동일한 이름의 비시각적 템플릿 유형이 존재합니다.

참고: QtQuick.Controls 임포트에서 제공하는 타입과의 중복을 피하기 위해 템플릿 임포트에 네임스페이스를 사용하는것이 좋습니다.

QML 유형

AbstractButton

버튼에 공통적으로 적용되는 기능을 제공하는 추상 기본 유형

Action

추상 사용자 인터페이스 액션

ActionGroup

액션을 그룹화합니다

ApplicationWindow

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

BusyIndicator

예를 들어 콘텐츠가 로드되는 동안과 같이 백그라운드 활동을 나타냅니다

Button

클릭하여 명령을 실행하거나 질문에 답할 수 있는 푸시 버튼

ButtonGroup

상호 배타적인 선택 가능 버튼 그룹

Calendar

달력 네임스페이스

CalendarModel

달력 모델

CheckBox

켜거나 끌 수 있는 체크 버튼

CheckDelegate

켜거나 끌 수 있는 체크 표시기가 있는 항목 델리게이트

ComboBox

옵션을 선택하기 위한 버튼과 팝업 목록의 결합

Container

컨테이너에 공통적으로 적용되는 기능을 제공하는 추상 기본 유형

ContextMenu

플랫폼에 적합한 방식으로 컨텍스트 메뉴를 여는 방법을 제공하는 부가형

Control

모든 컨트롤에 공통적인 기능을 제공하는 추상 기본 유형

DayOfWeekRow

일주일 중 요일 이름을 나열한 행

DelayButton

충분히 길게 누르면 작동하는 확인 버튼

Dial

값을 설정하기 위해 회전하는 원형 다이얼

Dialog

표준 버튼과 제목이 포함된 팝업 대화 상자로, 사용자와의 단기적인 상호작용에 사용됩니다

DialogButtonBox

대화 상자에서 사용되는 버튼 상자

DoubleSpinBox

사용자가 미리 설정된 부동소수점 값 집합에서 선택할 수 있게 해줍니다

Drawer

스와이프 제스처를 사용하여 열거나 닫을 수 있는 사이드 패널

Frame

컨트롤의 논리적 그룹을 나타내는 시각적 프레임

GroupBox

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

HorizontalHeaderView

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

HorizontalHeaderViewDelegate

ItemDelegate

다양한 뷰 및 컨트롤에서 사용할 수 있는 기본 항목 델리게이트

Label

상속된 글꼴을 적용한 스타일화된 텍스트 레이블

Menu

컨텍스트 메뉴 또는 팝업 메뉴로 사용할 수 있는 팝업

MenuBar

창 메뉴 바를 제공합니다

MenuBarItem

MenuBar 내에 드롭다운 메뉴를 표시합니다

MenuItem

메뉴 내에서 항목을 표시합니다

MenuSeparator

메뉴 내의 항목 그룹을 인접한 항목과 구분

MonthGrid

달력 월의 날짜 그리드

Overlay

팝업용 창 오버레이

Page

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

PageIndicator

현재 활성화된 페이지를 표시합니다

Pane

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

Popup

팝업 형태의 사용자 인터페이스 컨트롤의 기본 유형

ProgressBar

작업 진행 상황을 표시합니다

RadioButton

켜거나 끌 수 있는 배타적 라디오 버튼

RadioDelegate

켜거나 끌 수 있는 라디오 표시기가 있는 배타적 항목 델리게이트

RangeSlider

트랙을 따라 두 개의 핸들을 슬라이드하여 값의 범위를 선택하는 데 사용됩니다

RoundButton

사용자가 클릭할 수 있는 모서리가 둥근 푸시 버튼 컨트롤

ScrollBar

수직 또는 수평 상호작용형 스크롤 바

ScrollIndicator

수직 또는 수평 비상호작용형 스크롤 표시기

ScrollView

스크롤 가능한 뷰

SearchField

검색 기능에 사용하도록 설계된 특수한 입력 필드

SelectionRectangle

TableView 내의 테이블 셀을 선택하는 데 사용됩니다

Slider

트랙을 따라 핸들을 밀어서 값을 선택하는 데 사용됨

SpinBox

사용자가 미리 설정된 값 집합에서 선택할 수 있게 해줍니다

SplitHandle

SplitView 핸들을 위한 첨부 속성을 제공합니다

SplitView

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

StackView

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

SwipeDelegate

스와이프 가능한 항목 델리게이트

SwipeView

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

Switch

켜고 끌 수 있는 버튼

SwitchDelegate

켜거나 끌 수 있는 스위치 표시기가 있는 항목 델리게이트

TabBar

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

TabButton

TabBar에 어울리는 디자인의 버튼

TableViewDelegate

TableView에 할당할 수 있는 델리게이트

TextArea

여러 줄 텍스트 입력 영역

TextField

단일 줄 텍스트 입력 필드

ToolBar

컨텍스트에 반응하는 컨트롤을 담는 컨테이너

ToolButton

ToolBar에 어울리는 디자인의 버튼

ToolSeparator

툴바 내의 항목 그룹을 인접한 항목들과 구분해 줍니다

ToolTip

모든 컨트롤에 툴팁을 제공합니다

TreeViewDelegate

TreeView에 할당할 수 있는 델리게이트

Tumbler

선택 가능한 항목이 포함된 회전 가능한 휠

VerticalHeaderView

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

VerticalHeaderViewDelegate

WeekNumberColumn

주 번호가 표시된 열

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