ColorGroup QML Type
역할별 색상 집합입니다. 더 보기...
속성
- accent : color
(since 6.6) - alternateBase : color
- base : color
- brightText : color
- button : color
- buttonText : color
- dark : color
- highlight : color
- highlightedText : color
- light : color
- link : color
- linkVisited : color
- mid : color
- midlight : color
- placeholderText : color
(since 6.2) - shadow : color
- text : color
- toolTipBase : color
- toolTipText : color
- window : color
- windowText : color
신호
- changed()
상세 설명
색상 그룹 유형은 특정 역할을 가진 색상 집합을 정의하는 데 사용됩니다. 색상 그룹은 시각적인 외관은 없지만 렌더링된 항목을 사용자 지정하는 데 사용되는 색상을 정의합니다.
색상의 기본값은 기본으로 구성된 QPalette 의 활성 그룹 색상과 동일합니다.
다음 코드를 사용하여 일부 색상을 지정하여 색상 그룹을 만들 수 있습니다:
ColorGroup { alternateBase: "red" base: "green" }
Palette 유형은 각 QML 항목 상태에 대한 색상 그룹을 노출합니다.
속성 문서
accent : color [since 6.6]
일반적으로 base, window, button 색상을 대조하거나 보완하는 색상입니다. 일반적으로 사용자가 데스크톱 개인화를 위해 선택한 색상을 나타냅니다. 대화형 구성 요소의 스타일링이 일반적인 사용 사례입니다. 명시적으로 설정하지 않는 한 기본값은 highlight 입니다.
이 프로퍼티는 Qt 6.6에 도입되었습니다.
alternateBase : color
행 색이 번갈아 나타나는 항목 보기에서 대체 배경색으로 사용됩니다.
base : color
주로 텍스트 편집기 컨트롤 및 항목 보기의 배경색으로 사용됩니다. 일반적으로 흰색 또는 다른 밝은 색상을 사용합니다.
brightText : color
windowText 과는 매우 다른 텍스트 색상으로, 예를 들어 dark 과 잘 대비됩니다. 일반적으로 강조 표시된 버튼과 같이 text, windowText 또는 buttonText 이 대비가 좋지 않은 곳에 그려야 하는 텍스트에 사용됩니다.
button : color
일반 버튼 배경색입니다. 일부 스타일에는 버튼에 다른 배경색이 필요하므로 이 배경은 window 과 다를 수 있습니다.
buttonText : color
palette 색상과 함께 사용되는 전경색입니다.
dark : color
palette 색상과 함께 사용되는 전경색입니다.
highlight : color
선택한 항목 또는 현재 항목을 나타내는 색상입니다.
highlightedText : color
highlight 와 대비되는 텍스트 색상입니다.
light : color
button 보다 가볍습니다.
link : color
하이퍼링크에 사용되는 텍스트 색상입니다.
linkVisited : color
이미 방문한 하이퍼링크에 사용되는 텍스트 색상입니다.
mid : color
palette.button 와 dark 사이 .
midlight : color
button 와 light 사이 .
placeholderText : color [since 6.2]
편집 가능한 한 줄 필드의 자리 표시자 색상으로 사용됩니다.
이 프로퍼티는 Qt 6.2에 도입되었습니다.
shadow : color
매우 어두운 색상입니다.
text : color
base 와 함께 사용되는 전경색입니다. 이는 일반적으로 windowText 와 동일하며, 이 경우 window 및 base 와 좋은 대비를 제공해야 합니다.
toolTipBase : color
툴팁의 배경색으로 사용됩니다.
toolTipText : color
도구 설명의 전경색으로 사용됩니다.
window : color
일반적인 배경색입니다.
windowText : color
일반적인 전경색입니다.
신호 문서
changed()
추가 신호는 이 색상 그룹의 현재 상태가 변경되었음을 나타냅니다. 일반적으로 색상 중 하나가 변경되었음을 의미합니다.
참고: 해당 핸들러는 onChanged 입니다.
© 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.