このページでは

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.