Back to Qt.io
Contact Us Blog Download Qt

ColorGroup QML Type

역할별 색상 집합입니다. 더 보기...

Import Statement: import QtQuick
Inherits:

QtObject

Inherited By:

Palette

속성

신호

상세 설명

색상 그룹 유형은 특정 역할을 가진 색상 집합을 정의하는 데 사용됩니다. 색상 그룹은 시각적인 외관은 없지만 렌더링된 항목을 사용자 지정하는 데 사용되는 색상을 정의합니다.

색상의 기본값은 기본적으로 구성된 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 보다 밝은 색입니다.


하이퍼링크에 사용되는 텍스트 색상입니다.


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 입니다.


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