Qt Quick Controls

Qt Quick Controls 는 Qt Quick 에서 완전한 인터페이스를 구축하는 데 사용할 수 있는 컨트롤 세트를 제공합니다. 이 모듈은 Qt 5.7에 도입되었습니다.

Qt Quick Controls 사용자 정의 가능한 스타일을 선택할 수 있습니다. 자세한 내용은 스타일링 Qt Quick Controls 을 참조하십시오.

모듈 사용하기

QML API

모듈의 QML 유형은 QtQuick.Controls 가져오기를 통해 사용할 수 있습니다. 이 유형을 사용하려면 .qml 파일에 다음 가져오기 문을 추가합니다:

import QtQuick.Controls

C++ 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 을 참조하세요.

버튼 컨트롤

컨테이너 컨트롤

컨트롤 위임

인디케이터 컨트롤

입력 컨트롤

메뉴 컨트롤

탐색 컨트롤

팝업 컨트롤

구분 기호 컨트롤

버전

Qt Quick Controls 2.0은 Qt 5.7에 도입되었습니다. 이후의 마이너 Qt 릴리스에서는 Qt Quick Controls 모듈의 가져오기 버전이 한 단계씩 증가하여, Qt 5.12에서는 가져오기 버전이 Qt의 마이너 버전과 일치하게 됩니다.

Qt 6에서는 주 버전과 부 버전이 모두 일치하며, Qt Qml의 임포트에서 버전 번호가 생략될 수 있습니다. 버전이 생략된 경우 최신 버전이 사용됩니다.

실험용 Qt Labs 모듈은 임포트 버전 1.0을 사용합니다.

개정

Qt Quick Controls 구현 방식에 따라 추가된 새 속성은 같은 이름의 사용자 정의 속성과 충돌할 수 있습니다. 예를 들어 다음 스니펫은 오류가 발생합니다:

import QtQuick.Controls 2.13

ApplicationWindow {
    // ...

    ComboBox {
        anchors.centerIn: parent

        // As currentValue was added in 2.14, the versioned import above
        // should cause this property to be used, but instead an error is produced:
        // "Cannot override FINAL property"
        property int currentValue: 0
    }
}

충돌을 피하려면 이러한 속성의 이름을 바꿔야 합니다.

모듈 진화

Qt Quick Controls 는 원래 터치 인터페이스에 중점을 두고 작성되었습니다. 데스크톱 인터페이스 개발은 이미 가능하지만, 보다 네이티브한 모양과 느낌을 제공하기 위한 작업이 계속 진행 중입니다.

Qt Quick Controls 의 변경 사항에는 Qt 6 시리즈에 적용된 모듈 API 및 기능의 중요한 변경 사항이 나열되어 있습니다.

기사 및 가이드

• 시작하기
• 가이드라인
• 스타일링
• 아이콘
• 사용자 지정
• 파일 선택기 사용
• 배포
• 구성 파일
• 환경 변수

예제

• 갤러리
• 채팅 튜토리얼
• 텍스트 편집기
• 웨어러블 데모
• 자동차 예제
• 모든 예제

참조

• QML Types
• C++ Classes

관련 모듈

• Qt Quick
• Qt Quick 레이아웃
• Qt Quick 템플릿 2
• Qt Labs Platform

라이선스 및 속성

Qt Quick Controls 는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한 GNU 약소 일반 공중 사용 허가서 버전 3 또는 GNU 일반 공중 사용 허가서 버전 2에 따라 사용할 수 있습니다. 자세한 내용은 Qt 라이선스를 참조하십시오.

또한 Qt Quick Controls 에는 다음과 같은 허용 라이선스에 따라 타사 모듈이 포함될 수 있습니다: