Theme3D QML Type

グラフのビジュアルスタイル。詳細...

この型は非推奨です。新しいコードでの使用は強く推奨しません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• ambientLightStrength : real
• backgroundColor : color
• backgroundEnabled : bool
• baseColors : list<ThemeColor>
• baseGradients : list<ColorGradient>
• colorStyle : Theme3D.ColorStyle
• font : font
• gridEnabled : bool
• gridLineColor : color
• highlightLightStrength : real
• labelBackgroundColor : color
• labelBackgroundEnabled : bool
• labelBorderEnabled : bool
• labelTextColor : color
• lightColor : color
• lightStrength : real
• multiHighlightColor : color
• multiHighlightGradient : ColorGradient
• singleHighlightColor : color
• singleHighlightGradient : ColorGradient
• type : Theme3D.Theme
• windowColor : color

詳細説明

このタイプは、グラフ全体に影響を与える視覚的なプロパティを指定するために使用されます。そのまま使用することも、自由に変更することもできる、いくつかの組み込みテーマが用意されています。

以下のプロパティは、Abstract3DSeries プロパティを使用してシリーズ内で明示的に設定することで上書きできます：baseColors 、baseGradients 、およびcolorStyle 。

Theme3D.ThemeUserDefined 列挙型の値を使用することで、テーマをゼロから作成することもできます。

デフォルトのテーマ

次の表は、テーマによって制御されるプロパティと、Theme3D.ThemeUserDefined のデフォルト値を示しています。

使用例

変更を加えずに組み込みテーマを使用する場合：

Scatter3D {
    ...
    theme: Theme3D { type: Theme3D.ThemeRetro }
    ...
}

組み込みテーマを使用し、一部のプロパティを変更する場合：

Bars3D {
    ...
    theme: Theme3D {
        type: Theme3D.ThemeRetro
        labelBorderEnabled: true
        font.pointSize: 35
        labelBackgroundEnabled: false
    }
    ...
}

ユーザー定義のテーマを使用する場合：

Surface3D {
    ...
    theme: Theme3D {
        ambientLightStrength: 0.5
        backgroundColor: "red"
        backgroundEnabled: true
        baseColor: "blue"
        colorStyle: Theme3D.ColorStyleUniform
        font.family: "Lucida Handwriting"
        font.pointSize: 35
        gridEnabled: false
        gridLineColor: "black"
        highlightLightStrength: 0.5
        labelBackgroundColor: "black"
        labelBackgroundEnabled: true
        labelBorderEnabled: false
        labelTextColor: "white"
        lightColor: "yellow"
        lightStrength: 0.4
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
        windowColor: "white"
    }
    ...
}

Theme3D の列挙型については、Q3DTheme::ColorStyle およびQ3DTheme::Theme を参照してください。

プロパティのドキュメント

ambientLightStrength : real

グラフ全体の周囲の光の強度です。この値によって、光の位置に関係なく、グラフ全体で色がどれほど均一かつ明るく表示されるかが決まります。値は、0.0 から1.0 の範囲で指定する必要があります。

backgroundColor : color

グラフの背景色。

backgroundEnabled : bool

backgroundColor の値を使用して背景を描画するかどうかを指定します。

baseColors : list<ThemeColor>

グラフ内のすべてのオブジェクトに使用される基本色のリストで、系列ごとに指定されます。色の数よりも系列の数が多い場合、色リストはループし、リストの最初の色から再び繰り返されます。colorStyle がTheme3D.ColorStyleUniform でない場合、この設定は即座には反映されません。

これは、各系列でAbstract3DSeries.baseColor を明示的に設定することで上書きできます。

baseGradients : list<ColorGradient>

グラフ内のすべてのオブジェクトに対して、シリーズごとに使用されるベースグラデーションのリストです。シリーズの数よりグラデーションの数が多い場合、グラデーションのリストはループし、リストの最初のグラデーションから再び開始されます。

colorStyle がTheme3D.ColorStyleUniform に設定されている場合、この設定は直ちには反映されません。

この値は、系列内でAbstract3DSeries.baseGradient を明示的に設定することで上書きできます。

colorStyle : Theme3D.ColorStyle

グラフの色のスタイル。Q3DTheme::ColorStyle 列挙型の値のいずれかです。

この値は、系列内でAbstract3DSeries.colorStyle を明示的に設定することで上書きできます。

「Q3DTheme::ColorStyle」も参照してください 。

font : font

ラベルに使用するフォントを設定します。

gridEnabled : bool

グリッド線を表示するかどうかを指定します。この設定は、すべてのグリッド線に適用されます。

gridLineColor : color

グリッド線の色。

highlightLightStrength : real

選択したオブジェクトの鏡面反射光の強度。値は0.0 から10.0 の範囲で指定する必要があります。

labelBackgroundColor : color

ラベルの背景色です。labelBackgroundEnabled がfalse に設定されている場合は、この設定は適用されません。

labelBackgroundEnabled : bool

ラベルを、labelBackgroundColor （アルファ値を含む）を使用した背景付きで描画するか、完全に透明な背景で描画するかを指定します。背景付きラベルは、各軸ごとに最も長いラベルに基づいて均等なサイズで描画され、テキストはその中央に配置されます。背景なしのラベルはそのまま描画され、グラフ内での位置に応じて左揃えまたは右揃えになります。

labelBorderEnabled : bool

背景色を持つラベルに対して、ラベルの枠線を表示するかどうかを指定します。labelBackgroundEnabled がfalse に設定されている場合は、この設定は効果を持ちません。

labelTextColor : color

ラベルに使用されるフォントの色。

lightColor : color

Scene3D で定義された環境光および鏡面反射光の色。

lightStrength : real

グラフ全体のスペキュラー光の強度です。値は0.0 から10.0 の範囲で指定する必要があります。

この値は、Scene3Dで指定された光に影響を与えます。

multiHighlightColor : color

選択されたオブジェクトのハイライト色。selectionMode にAbstractGraph3D.SelectionRow またはAbstractGraph3D.SelectionColumn フラグが設定されている場合に使用されます。

multiHighlightGradient : ColorGradient

選択されたオブジェクトのハイライトグラデーション。selectionMode にAbstractGraph3D.SelectionRow またはAbstractGraph3D.SelectionColumn フラグが設定されている場合に使用されます。

singleHighlightColor : color

選択されたオブジェクトのハイライト色。selectionMode にAbstractGraph3D.SelectionItem フラグが設定されている場合に使用されます。

singleHighlightGradient : ColorGradient

選択されたオブジェクトのハイライトグラデーション。selectionMode にAbstractGraph3D.SelectionItem フラグが設定されている場合に使用されます。

type : Theme3D.Theme

テーマのタイプ。タイプが設定されていない場合、タイプはTheme3D.ThemeUserDefined となります。アイテムの構築後にテーマのタイプを変更すると、テーマの他のすべてのプロパティが、事前定義されたテーマで指定されている値に変更されます。グラフのアクティブなテーマのタイプを変更すると、関連付けられているすべての系列もリセットされ、新しいテーマが適用されます。

windowColor : color

グラフが描画されるアプリケーションウィンドウの色。