Qt Quick Controls 구성 파일

Qt Quick Controls 는 애플리케이션 리소스에 내장된 특수 구성 파일인 ` qtquickcontrols2.conf`을 지원합니다.

이 구성 파일에서는 선호하는 스타일과 특정 스타일별 속성을 지정할 수 있습니다. 다음 예제는 선호하는 스타일을 Material 스타일로 지정합니다. 또한, 애플리케이션이 Material 스타일로 실행될 경우 테마는 밝게 표시되며, 강조색과 주색은 각각 청록색과 청회색으로 설정됩니다. 그러나 애플리케이션이 Universal 스타일로 실행될 경우, 강조색은 빨간색으로 표시되며 시스템 테마 색상에 따라 적절한 테마가 선택됩니다.

[Controls]
Style=Material

[Universal]
Theme=System
Accent=Red

[Material]
Theme=Light
Accent=Teal
Primary=BlueGrey

QT_QUICK_CONTROLS_CONF 환경 변수를 사용하여 구성 파일의 사용자 지정 위치를 지정할 수 있습니다.

컨트롤 섹션

구성 파일의 ` Controls ` 섹션에서는 다음 값을 지정할 수 있습니다:

Imagine 섹션

다음 표는 구성 파일의 ` Imagine ` 섹션에서 Imagine 스타일을 구성하는 데 사용할 수 있는 값들을 나열합니다:

[Imagine]
Path=:/imagine-assets

[Imagine]
Path=imagine-assets

머티리얼 섹션

다음 표에는 구성 파일의 Material 섹션에서 Material 스타일을 구성하는 데 사용할 수 있는 값들이 나열되어 있습니다:

범용 섹션

다음 표는 구성 파일의 Universal 섹션에서 유니버설 스타일을 구성하는 데 사용할 수 있는 값을 나열합니다:

글꼴 구성

기본 font 는 구성 파일 내 각 스타일 섹션의 Font 하위 그룹에서 지정할 수 있습니다:

[Basic]
Font\Family=Open Sans
Font\PixelSize=20

지원되는 글꼴 속성:

팔레트 구성

기본 palette 는 구성 파일의 Palette 하위 그룹을 사용하여 각 스타일별로 구성할 수 있습니다. Palette 하위 그룹은 다음 두 가지 방법으로 정의할 수 있습니다:

[Fusion]
Palette\Window=#dedede
Palette\WindowText=#212121

자세한 내용은 Palette QML 타입을 참조하십시오.

프로젝트에서 구성 파일 사용하기

Qt Quick Controls 가 구성 파일을 찾을 수 있도록 하려면, Qt 리소스 시스템을 사용하여 해당 파일을 애플리케이션의 리소스에 포함시켜야 합니다. 다음은 .qrc 파일의 예시입니다:

<!DOCTYPE RCC><RCC version="1.0">
<qresource prefix="/">
    <file>qtquickcontrols2.conf</file>
</qresource>
</RCC>

마지막으로, .qrc 파일은 애플리케이션의 빌드 파일에 반드시 명시되어야 합니다. 예를 들면 다음과 같습니다:

set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
    application.qrc
    main.cpp
    ...
)

RESOURCES = application.qrc
...

참조: 빌드 시스템 통합

관련 정보

• 스타일링 Qt Quick Controls
• 에서 지원되는 환경 변수 Qt Quick Controls