이 페이지에서

ColorGroup QML Type

역할별 색상 세트. 더 보기...

Import Statement: import QtQuick
Inherits:

QtObject

Inherited By:

Palette

속성

신호

상세 설명

ColorGroup 유형은 특정 역할을 가진 색상 집합을 정의하는 데 사용됩니다. ColorGroup은 시각적으로 표시되지는 않지만, 렌더링된 항목을 사용자 정의하는 데 사용되는 색상을 정의합니다.

색상의 기본값은 기본 생성된 ` 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

일반적인 전경색입니다.

Signal 문서

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.