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()
詳細な説明
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 よりも軽量です。
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
一般的な前景色。
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.