Qt Quick Controls 구성 파일
Qt Quick Controls 은 애플리케이션의 리소스에 내장된 특수 구성 파일( qtquickcontrols2.conf)을 지원합니다.
구성 파일은 기본 설정 스타일과 특정 스타일별 속성을 지정할 수 있습니다. 다음 예제에서는 기본 스타일을 머티리얼 스타일로 지정합니다. 또한 머티리얼 스타일로 애플리케이션을 실행하면 테마는 밝고 강조 및 기본 색상은 각각 청록색과 파란색 회색이 됩니다. 그러나 애플리케이션이 대신 유니버설 스타일로 실행되는 경우 강조 색상은 빨간색이며 시스템 테마 색상에 따라 적절한 테마가 선택됩니다.
[Controls] Style=Material [Universal] Theme=System Accent=Red [Material] Theme=Light Accent=Teal Primary=BlueGrey
환경 변수를 사용하여 구성 파일의 사용자 지정 위치를 QT_QUICK_CONTROLS_CONF로 지정할 수 있습니다.
컨트롤 섹션
구성 파일의 Controls 섹션에 다음 값을 지정할 수 있습니다:
| 변수 | 설명 |
|---|---|
Style | 애플리케이션을 실행할 스타일을 지정합니다. 값은 기본 제공 스타일 또는 사용자 지정 스타일 중 하나의 이름일 수 있습니다. |
FallbackStyle | 구현되지 않은 컨트롤에 사용할 스타일을 지정합니다. 스타일은 기본 제공 스타일 중 하나이어야 합니다. 기본적으로 기본 스타일이 사용됩니다. |
상상 섹션
다음 표에는 구성 파일의 Imagine 섹션에서 상상하기 스타일을 구성하는 데 사용할 수 있는 값이 나열되어 있습니다:
| 변수 | 설명 |
|---|---|
Path | 상상하기 스타일 에셋이 포함된 디렉터리 경로를 지정합니다. 지정하지 않으면 기본 제공 자산이 사용됩니다. 예를 들어 리소스 시스템에 저장된 디렉터리 경로를 지정합니다: [Imagine] Path=:/imagine-assets 로컬 디렉터리에 대한 상대 경로를 지정합니다: [Imagine] Path=imagine-assets 참고: 기술적인 제한으로 인해 경로가 |
머티리얼 섹션
다음 표에는 구성 파일의 Material 섹션에서 머티리얼 스타일을 구성하는 데 사용할 수 있는 값이 나열되어 있습니다:
| 변수 | 설명 |
|---|---|
Theme | 기본 머티리얼 테마를 지정합니다. 값은 사용 가능한 테마 중 하나(예: "Dark")일 수 있습니다. |
Variant | 머티리얼 배리언트를 지정합니다. 머티리얼 디자인에는 터치 장치용으로 설계된 일반 변형과 데스크톱용 고밀도 변형의 두 가지 변형이 있습니다. 고밀도 변형은 컨트롤과 해당 글꼴에 더 작은 크기를 사용합니다. 값은 |
Accent | 기본 머티리얼 강조 색상을 지정합니다. 값은 color 일 수 있지만 미리 정의된 머티리얼 색상 중 하나를 사용하는 것이 좋습니다(예: "Teal"). |
Primary | 기본 머티리얼 기본 색을 지정합니다. 값은 아무거나 color 일 수 있지만 미리 정의된 머티리얼 색상 중 하나를 사용하는 것이 좋습니다(예: "BlueGrey"). |
Foreground | 기본 머티리얼 전경색을 지정합니다. 값은 color 또는 미리 정의된 머티리얼 색상 중 하나(예: "Brown")를 사용할 수 있습니다. |
Background | 기본 머티리얼 배경색을 지정합니다. 값은 color 또는 미리 정의된 머티리얼 색상 중 하나(예: "Grey")일 수 있습니다. |
유니버설 섹션
다음 표에는 구성 파일의 Universal 섹션에서 유니버설 스타일을 구성하는 데 사용할 수 있는 값이 나열되어 있습니다:
| 변수 | 설명 |
|---|---|
Theme | 기본 유니버설 테마를 지정합니다. 값은 사용 가능한 테마 중 하나(예: "Dark")일 수 있습니다. |
Accent | 기본 유니버설 강조 색상을 지정합니다. 값은 color 일 수 있지만 미리 정의된 유니버설 색상 중 하나를 사용하는 것이 좋습니다(예: "Violet"). |
Foreground | 기본 범용 전경색을 지정합니다. 값은 color 또는 사전 정의된 범용 색상 중 하나(예: "Brown")를 사용할 수 있습니다. |
Background | 기본 범용 배경색을 지정합니다. 값은 color 또는 사전 정의된 범용 색상 중 하나(예: "Steel")일 수 있습니다. |
글꼴 구성
기본값 font 은 구성 파일의 각 스타일 섹션에 있는 Font 하위 그룹에서 지정할 수 있습니다:
[Basic] Font\Family=Open Sans Font\PixelSize=20
지원되는 글꼴 속성:
| 변수 | 설명 |
|---|---|
Family | font family. |
PointSize | point size. |
PixelSize | pixel size. |
StyleHint | style hint. 사용 가능한 값입니다: SansSerif, Helvetica, Serif, Times, TypeWriter, Courier, OldEnglish, Decorative, Monospace, Fantasy, Cursive. |
Weight | weight. Qt는 OpenType과 호환되는 1 에서 1000 까지의 가중치 스케일을 사용합니다. 1 의 가중치는 가늘고 1000 은 매우 검은색입니다. 사용 가능한 사전 정의된 가중치: Thin (100), ExtraLight (200), Light (300), Normal (400), Medium (500), DemiBold (600), Bold (700), ExtraBold (800), Black (900). |
Style | style. 사용 가능한 값 StyleNormal, StyleItalic, StyleOblique. |
팔레트 구성
기본값 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>
참고: Qt Quick Controls 은 파일 선택기를 사용하여 구성 파일을 로드합니다. 플랫폼과 로케일에 따라 다른 구성 파일을 제공할 수 있습니다. 자세한 내용은 QFileSelector 문서를 참조하세요.
마지막으로 애플리케이션의 빌드 파일에 .qrc 파일을 나열해야 합니다. 예를 들어
set(CMAKE_AUTORCC ON)
qt_add_executable(my_app
application.qrc
main.cpp
...
)RESOURCES = application.qrc ...
참고 항목도 참조하세요: 빌드 시스템 통합
관련 정보
© 2025 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.
