이 페이지에서

xml-ph-0000@deepl.internal에서 지원하는 환경 변수 Qt Quick Controls

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

변수설명
QT_QUICK_CONTROLS_STYLEQt 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_SMOOTH9-patch 이미지의 부드러운 스케일링을 활성화하려면 1 로 설정하십시오. 이 환경 변수는 Qt 6.5에서 추가되었습니다.

머티리얼 스타일 전용 환경 변수:

변수설명
QT_QUICK_CONTROLS_MATERIAL_THEME기본 Material 테마를 지정합니다. 값은 사용 가능한 테마 중 하나여야 하며, 예를 들어 "Dark" 와 같이 설정할 수 있습니다.
QT_QUICK_CONTROLS_MATERIAL_VARIANTMaterial 변형을 지정합니다. Material Design에는 터치 기기용으로 설계된 일반 변형과 데스크톱용 고밀도 변형의 두 가지 변형이 있습니다. 고밀도 변형은 컨트롤과 해당 글꼴의 크기를 더 작게 사용합니다.

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

QT_QUICK_CONTROLS_MATERIAL_ACCENT기본 Material 강조색을 지정합니다. 값은 color 중 아무 것이나 될 수 있지만, "Teal" 과 같이 미리 정의된 Material 색상 중 하나를 사용하는 것이 권장됩니다.
QT_QUICK_CONTROLS_MATERIAL_PRIMARY기본 Material 주 색상을 지정합니다. 값은 color 의 모든 색상으로 설정할 수 있지만, "BlueGrey" 와 같이 미리 정의된 Material 색상 중 하나를 사용하는 것이 권장됩니다.
QT_QUICK_CONTROLS_MATERIAL_FOREGROUND기본 Material 전경색을 지정합니다. 값은 임의의 color 일 수 있으며, 미리 정의된 Material 색상 중 하나(예: "Brown")를 사용하는 것이 권장됩니다.
QT_QUICK_CONTROLS_MATERIAL_BACKGROUND기본 Material 배경색을 지정합니다. 값은 임의의 color 이거나, 미리 정의된 Material 색상 중 하나(예: "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")일 수 있습니다.

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