バージョン

チャートにオーバーライドを適用

オーバーライドは、カラー モデルや視覚効果などの既存の規則をオーバーライドして、行や列数に基づいてグラフ要素に規則を適用するために使用できます。

グラフにオーバーライドを適用するには、単に UltraChart.Resources.Appearance.Override オブジェクトのインスタンスを作成し、プロパティを設定して、 UltraChart.Override コレクションに追加します。

オーバーライドは、以下のプロパティの影響を受けます。

  • Override.Row :このオーバーライドに一致するデータ行のインデックス。すべての行を一致させるには、このプロパティを -2 に設定します。

  • Override.Column :このオーバーライドに一致するデータ列のインデックス。すべての列を一致させるには、このプロパティを -2 に設定します。

  • Override.Enabled :オーバーライドをアクティブにするか、しないかを決定します。オーバーライドのオン/オフを切り替える最も簡単な方法は、このプロパティの True と False を切り替えることです。

  • Override.PE :このオーバーライドの行と列に一致するプリミティブに適用する PaintElement。 Boxes 、 Ellipses 、および Polylines などの SceneGraph のすべてのプリミティブは、Override の行および列のプロパティ設定と一致する場合、この PaintElement が適用されます。

以下に、実行中のオーバーライドの画像とこれらのオーバーライドをグラフに適用するために使用するサンプル コードを示します。

images\Chart Apply an Override to a Chart 01.png

Visual Basic の場合：

Imports Infragistics.UltraChart.Resources.Appearance
Imports Infragistics.UltraChart.Shared.Styles
...
Dim override1 As New Override()
override1.Column = -2 ' すべてのデータ列を一致させます
override1.Row = 0 ' row #0 のみ
override1.PE = New PaintElement(Color.Blue, Color.Silver, 255, 150, GradientStyle.ForwardDiagonal, PaintElementType.Gradient)
Me.ultraChart1.Override.Add(override1)
Dim override2 As New Override()
override2.Column = 1 ' column #1 のみ
override2.Row = -2 ' すべてのデータ行を一致させます
override2.PE = New PaintElement(Color.Orange)
Me.ultraChart1.Override.Add(override2)
Dim override3 As New Override()
override3.Column = 1 ' column #1 のみ
override3.Row = 0 ' row #0 のみ
override3.PE = New PaintElement(Color.HotPink)
Me.ultraChart1.Override.Add(override3)
' コレクションに追加された最後のオーバーライドである override3 が、
' 以前のすべてのオーバーライドを引き継ぎます。
Me.ultraChart1.InvalidateLayers()

C# の場合：

using Infragistics.UltraChart.Resources.Appearance;
using Infragistics.UltraChart.Shared.Styles;
...
Override override1 = new Override();
override1.Column = -2; // すべてのデータ列を一致させます
override1.Row    =  0; // row #0 のみ
override1.PE = new PaintElement(Color.Blue, Color.Silver, 255, 150, GradientStyle.ForwardDiagonal, PaintElementType.Gradient);
this.ultraChart1.Override.Add(override1);
Override override2 = new Override();
override2.Column =  1; // column #1 のみ
override2.Row    = -2; // すべてのデータ行を一致させます
override2.PE = new PaintElement(Color.Orange);
this.ultraChart1.Override.Add(override2);
Override override3 = new Override();
override3.Column =  1; // column #1 のみ
override3.Row    =  0; // row #0 のみ
override3.PE = new PaintElement(Color.HotPink);
this.ultraChart1.Override.Add(override3);
// コレクションに追加された最後のオーバーライドである override3 が、
// 以前のすべてのオーバーライドを引き継ぎます。
this.ultraChart1.InvalidateLayers();