Qt Quick Controls
Qt Quick Controls Qt Quick 에서 완전한 인터페이스를 구축하는 데 사용할 수 있는 일련의 컨트롤이 제공됩니다.
Qt Quick Controls 사용자 정의가 가능한 다양한 스타일이 제공됩니다. 자세한 내용은 ‘ Qt Quick Controls 스타일 지정’을 참조하십시오.
모듈 사용법
QML API
이 모듈의 QML 유형은 ` QtQuick.Controls ` 임포트를 통해 사용할 수 있습니다. 해당 유형을 사용하려면 .qml 파일에 다음 임포트 문장을 추가하십시오:
import QtQuick.ControlsC++ API
Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리를 직접 또는 다른 종속성을 통해 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 위해 전용 지원을 제공합니다.
CMake를 사용한 빌드
` find_package() ` 명령을 사용하여 ` Qt6 ` 패키지에서 필요한 모듈 구성 요소를 찾으십시오:
find_package(Qt6 REQUIRED COMPONENTS QuickControls2)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.
qmake를 사용한 빌드
qmake를 사용하여 모듈을 빌드하도록 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 모듈을 추가하십시오:
QT += quickcontrols2소스 코드로부터 빌드하기
' Qt Image Formats 모듈을 사용하는 것이 권장되지만, 필수는 아닙니다. 이 모듈은 Imagine 스타일이 사용하는 .webp 형식을 지원합니다.
제어
Qt Quick Controls 의 전체 목록은 QML Types 을 참조하십시오.
버튼 컨트롤
버튼에 공통적으로 적용되는 기능을 제공하는 추상 기본 유형 | |
명령을 실행하거나 질문에 답하기 위해 클릭할 수 있는 푸시 버튼 | |
켜거나 끌 수 있는 체크 버튼 | |
충분히 오래 누르고 있으면 작동하는 체크 버튼 | |
켜거나 끌 수 있는 배타적 라디오 버튼 | |
사용자가 클릭할 수 있는 모서리가 둥근 푸시 버튼 컨트롤 | |
켜거나 끌 수 있는 버튼 | |
툴바에 어울리는 디자인의 버튼 |
컨테이너 컨트롤
헤더와 푸터를 지원하는 스타일이 적용된 최상위 창 | |
컨테이너에 공통적으로 필요한 기능을 제공하는 추상 기본 유형 | |
컨트롤의 논리적 그룹을 위한 시각적 프레임 | |
컨트롤의 논리적 그룹을 위한 시각적 프레임 및 제목 | |
TableView와 함께 사용할 수 있는 가로형 헤더 뷰를 제공합니다 | |
헤더와 푸터를 지원하는 스타일링된 페이지 컨트롤 | |
애플리케이션 스타일 및 테마와 일치하는 배경을 제공합니다 | |
스크롤 가능한 뷰 | |
각 항목 사이에 드래그 가능한 스플리터를 배치하여 항목을 배치합니다 | |
스택 기반 탐색 모델을 제공합니다 | |
사용자가 옆으로 스와이프하여 페이지를 탐색할 수 있도록 지원 | |
사용자가 서로 다른 뷰나 하위 작업 간에 전환할 수 있도록 합니다 | |
컨텍스트에 따라 달라지는 컨트롤을 담는 컨테이너 | |
TableView와 함께 사용할 수 있는 세로형 헤더 뷰를 제공합니다 |
델리게이트 컨트롤
켜거나 끌 수 있는 체크 표시기가 있는 항목 델리게이트 | |
다양한 뷰 및 컨트롤에서 사용할 수 있는 기본 항목 델리게이트 | |
켜거나 끌 수 있는 라디오 표시기가 있는 전용 항목 델리게이트 | |
스와이프 가능한 항목 델리게이트 | |
켜거나 끌 수 있는 스위치 표시기가 있는 항목 델리게이트 | |
TableView에 할당할 수 있는 델리게이트 | |
TreeView에 할당할 수 있는 델리게이트 | |
표시기 컨트롤
예를 들어 콘텐츠가 로드되는 동안과 같이 백그라운드 활동을 표시합니다 | |
현재 활성화된 페이지를 표시합니다 | |
작업 진행 상황을 나타냅니다 | |
수직 또는 수평 상호작용형 스크롤 막대 | |
수직 또는 수평 비상호작용형 스크롤 표시기 |
입력 컨트롤
옵션을 선택하기 위한 버튼과 팝업 목록의 조합 | |
값을 설정하기 위해 회전하는 원형 다이얼 | |
사용자가 미리 설정된 부동 소수점 값 집합에서 선택할 수 있게 해줌 | |
트랙을 따라 두 개의 핸들을 슬라이딩하여 값의 범위를 선택하는 데 사용 | |
검색 기능에 사용하도록 설계된 특수한 입력 필드 | |
트랙을 따라 핸들을 슬라이드하여 값을 선택하는 데 사용됩니다 | |
사용자가 미리 설정된 값 집합 중에서 선택할 수 있게 해줍니다 | |
여러 줄 텍스트 입력 영역 | |
단일 줄 텍스트 입력 필드 | |
선택 가능한 항목이 표시된 회전 가능한 휠 |
메뉴 컨트롤
'Attached' 유형은 플랫폼에 적합한 방식으로 컨텍스트 메뉴를 열 수 있는 방법을 제공합니다 | |
컨텍스트 메뉴 또는 팝업 메뉴로 사용할 수 있는 팝업 | |
창 메뉴 모음을 제공합니다 | |
메뉴 바 내에 드롭다운 메뉴를 표시합니다 | |
메뉴 내에 항목을 표시합니다 |
탐색 컨트롤
스와이프 제스처를 사용하여 열거나 닫을 수 있는 사이드 패널 | |
스택 기반 탐색 모델을 제공합니다 | |
사용자가 옆으로 스와이프하여 페이지를 이동할 수 있게 함 | |
사용자가 서로 다른 보기나 하위 작업 간에 전환할 수 있도록 합니다 | |
탭 바(TabBar)에 어울리는 디자인의 버튼 |
팝업 컨트롤
표준 버튼과 제목이 포함된 팝업 대화 상자로, 사용자와의 단기적인 상호 작용에 사용됩니다 | |
스와이프 제스처를 사용하여 열거나 닫을 수 있는 사이드 패널 | |
컨텍스트 메뉴 또는 팝업 메뉴로 사용할 수 있는 팝업 | |
팝업 형태의 사용자 인터페이스 컨트롤의 기본 유형 | |
모든 컨트롤에 툴팁을 제공합니다 |
분리선 컨트롤
메뉴 내의 항목 그룹을 인접한 항목과 구분합니다 | |
툴바 내의 항목 그룹을 인접한 항목과 구분합니다 |
모듈의 진화
Qt Quick Controls 는 원래 터치 인터페이스를 주된 목표로 개발되었습니다. 이미 데스크톱 인터페이스를 개발하는 것은 가능하지만, 보다 네이티브한 룩앤필을 제공하기 위한 작업이 진행 중입니다.
Qt Quick Controls 에는 Qt 6 시리즈를 위해 모듈 API 및 기능에 적용된 주요변경 사항이 나열되어 있습니다.
버전 관리 체계는 Qt Quick Controls 에 적용된 버전 관리 체계를 설명합니다.
기사 및 가이드
예제
참조
관련 모듈
라이선스 및 출처 표기
Qt Quick Controls 는 The Qt Company의 상용 라이선스 하에 제공됩니다. 또한, GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 2 하에서도 이용 가능합니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.
또한, Qt Quick Controls 에는 다음의 허용적인 라이선스에 따라 제공되는 제3자 모듈이 포함될 수 있습니다:
© 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.
