지원되는 환경 변수 Qt Quick Controls

이 페이지에는 Qt Quick Controls 에서 지원하는 모든 환경 변수 목록이 포함되어 있습니다. 환경 변수는 주로 테스트 용도로 사용되지만 시스템 전체 기본값을 설정하는 데에도 사용할 수 있습니다.

변수설명
QT_QUICK_CONTROLS_STYLE기본 Qt Quick Controls 스타일을 지정합니다. 이 값은 기본 제공 스타일(예: "Material")이나 사용자 정의 스타일(예: "MyStyle") 중 하나 일 수 있습니다.
QT_QUICK_CONTROLS_FALLBACK_STYLE사용자 정의 스타일에 대한 대체 스타일을 지정합니다. 값은 기본 제공 스타일 중 하나(예: "Material")일 수 있습니다,
QT_QUICK_CONTROLS_CONFQt Quick Controls 구성 파일의 위치를 지정합니다. 기본적으로 구성 파일은 ":/qtquickcontrols2.conf" 에 있는 애플리케이션의 리소스에서 로드됩니다.
QT_QUICK_CONTROLS_HOVER_ENABLEDQt Quick Controls 사용 여부를 지정합니다 hover effects. 이 값을 0 또는 1 로 설정하여 각각 호버 효과를 비활성화하거나 활성화할 수 있습니다.

스타일별 환경 변수를상상해 보세요:

변수설명
QT_QUICK_CONTROLS_IMAGINE_PATHImagine 스타일 에셋이 포함된 디렉터리 경로를 지정합니다. 지정하지 않으면 기본 제공 에셋이 사용됩니다.

예를 들어 리소스 시스템에 저장된 디렉터리 경로를 지정합니다:

QT_QUICK_CONTROLS_IMAGINE_PATH=:/imagine-assets

로컬 디렉터리에 대한 상대 경로를 지정하려면 다음과 같이 합니다:

QT_QUICK_CONTROLS_IMAGINE_PATH=imagine-assets

참고: 기술적인 제한으로 인해 경로가 qtquickcontrols2.conf 파일에 상대적인 경로인 경우 "imagine"이라는 이름을 지정해서는 안 됩니다.

QT_QUICK_CONTROLS_IMAGINE_SMOOTH1 로 설정하면 9 패치 이미지의 크기를 부드럽게 조정할 수 있습니다. 이 환경 변수는 Qt 6.5에 추가되었습니다.

머티리얼 스타일별 환경 변수

변수설명
QT_QUICK_CONTROLS_MATERIAL_THEME기본 머티리얼 테마를 지정합니다. 값은 사용 가능한 테마 중 하나(예: "Dark")일 수 있습니다.
QT_QUICK_CONTROLS_MATERIAL_VARIANT머티리얼 배리언트를 지정합니다. 머티리얼 디자인에는 터치 장치용으로 설계된 일반 변형과 데스크톱용 고밀도 변형의 두 가지 변형이 있습니다. 고밀도 변형은 컨트롤과 해당 글꼴에 더 작은 크기를 사용합니다.

값은 "Normal" 또는 "Dense" 일 수 있습니다.

QT_QUICK_CONTROLS_MATERIAL_ACCENT기본 머티리얼 강조 색상을 지정합니다. 값은 color 일 수 있지만 미리 정의된 머티리얼 색상 중 하나를 사용하는 것이 좋습니다(예: "Teal").
QT_QUICK_CONTROLS_MATERIAL_PRIMARY기본 머티리얼 기본 색을 지정합니다. 값은 아무거나 color 일 수 있지만 미리 정의된 머티리얼 색상 중 하나를 사용하는 것이 좋습니다(예: "BlueGrey").
QT_QUICK_CONTROLS_MATERIAL_FOREGROUND기본 머티리얼 전경색을 지정합니다. 값은 color 또는 미리 정의된 머티리얼 색상 중 하나(예: "Brown")를 사용할 수 있습니다.
QT_QUICK_CONTROLS_MATERIAL_BACKGROUND기본 머티리얼 배경색을 지정합니다. 값은 color 또는 사전 정의된 머티리얼 색상 중 하나(예: "Grey")일 수 있습니다.

범용 스타일별 환경 변수:

변수설명
QT_QUICK_CONTROLS_UNIVERSAL_THEME기본 유니버설 테마를 지정합니다. 값은 사용 가능한 테마 중 하나(예: "Dark")일 수 있습니다.
QT_QUICK_CONTROLS_UNIVERSAL_ACCENT기본 유니버설 강조 색상을 지정합니다. 값은 color 일 수 있지만 미리 정의된 유니버설 색상 중 하나를 사용하는 것이 좋습니다(예: "Violet").
QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND기본 범용 전경색을 지정합니다. 값은 color 또는 사전 정의된 범용 색상 중 하나(예: "Brown")를 사용할 수 있습니다.
QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND기본 범용 배경색을 지정합니다. 값은 color 또는 미리 정의된 범용 색상 중 하나(예: "Steel")일 수 있습니다.

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