カテゴリ強調表示レイヤー

トピックの概要

目的

このトピックは、ホバー操作に使用されるカテゴリ強調表示レイヤーについての情報を提供します。カテゴリ強調表示レイヤーのプロパティについて説明し、実装例を示します。

前提条件

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック	目的
データチャートを使用した作業の開始	UltraDataChart コントロールは、コントロールの DataContext プロパティにマップされるデータオブジェクトモデルを必要とします。ここでは、簡単なデータオブジェクトモデルを提供しますが、自分自身で作成し、このサンプルコードの代わりに使用することができます。
カテゴリシリーズ	このトピックは、UltraDataChart コントロールのカテゴリシリーズのさまざまなタイプを説明します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

概要
プレビュー
プロパティ
例
関連コンテンツ

概要

カテゴリ強調表示レイヤーの概要

CategoryHighlightLayer は、UltraDataChart コントロール内の 1 つまたはすべてのカテゴリー軸を対象にしています。軸に、軸の主グリッド線の間に配置されるシリーズ、たとえば ColumnSeries などが含まれる場合、現在のカテゴリを塗りつぶすシェイプが描画されます。

LineSeries シリーズなどその他のシリーズの場合、ポインター位置に最も近いグリッドラインで調節可能な厚さを持つバンドを描画します。この場合、 UseInterpolation プロパティが有効になると、x 位置がポインターの x 位置に付け加えられます。

Brush プロパティを設定することによって、強調表示領域の色を変更できます。このプロパティの詳細は、以下の共通のプロパティセクションを参照してください。

プレビュー

以下の画像は、CategoryHighlightLayer を追加して描画した UltraDataChart コントロールのプレビューです。

プロパティ

カテゴリ強調表示レイヤーのサマリー

以下の表で、 CategoryHighlightLayer レイヤーのプロパティを簡単に説明します。

プロパティ名	プロパティタイプ	説明
BandHighlightWidth	`double`	このプロパティは、グリッドライン上に配置されたシリーズの強調表示領域の幅を指定します。たとえば、 LineSeries、 AreaSeries および SplineSeries です。このプロパティは、グリッドライン間に配置されたシリーズがある場合は影響を及ぼしません。たとえば、 ColumnSeries および WaterfallSeries です。このプロパティが設定されると、グリッドラインの周りに指定されたサイズの縞模様シェイプを強調表示します。
TargetAxis	`CategoryAxisBase`	このプロパティは、どの軸に有効なカテゴリ強調表示レイヤーを設定するかを指定します。
UseInterpolation	`bool`	このプロパティは、強調表示バンドがグリッドラインにスナップするのでなくカーソルにスナップすべきかどうかを指定します。このプロパティは、グリッドライン間に配置されたシリーズがある場合は影響を及ぼしません。たとえば、 ColumnSeries および WaterfallSeries です。

例

以下のスクリーンショットは、以下の設定の結果、 categoryHighlightLayer オブジェクトの bandHighlightWidth プロパティを持つ UltraDataChart コントロールの外観がどのように見えるかを示しています。

プロパティ	値
BandHighlightWidth	`50`

以下のコードはこの例を実装します。

C# の場合:

var catHighlightLayerSeries = new CategoryHighlightLayer();
catHighlightLayerSeries.BandHighlightWidth = 50;
theChart.Series.Add(catHighlightLayerSeries);

VB の場合:

Dim catHighlightLayerSeries As New CategoryHighlightLayer()
catHighlightLayerSeries.BandHighlightWidth = 50
theChart.Series.Add(catHighlightLayerSeries)

関連コンテンツ

トピック	目的
共通のプロパティ	このトピックは、ホバー操作機能が、 Series クラスから継承したツールチップの相互作用を強調表示、ホバリングおよび相互作用するために使用するプロパティおよびメソッドについての情報を提供します。
十字線レイヤー	このトピックは、ホバー操作に使用される十字線レイヤーについての情報を提供します。十字線のプロパティについて説明し、実装例を示します。
カテゴリ項目強調表示レイヤー	このトピックは、ホバー操作に使用されるカテゴリ項目強調表示レイヤーについての情報を提供します。カテゴリ項目強調表示レイヤーのプロパティについて説明し、実装例を示します。
カテゴリツールチップレイヤー	このトピックは、ホバー操作に使用されるカテゴリツールチップレイヤーについての情報を提供します。カテゴリツールチップレイヤーのプロパティについて説明し、実装例を提供します。
項目ツールチップレイヤー	このトピックは、ホバー操作に使用される項目ツールチップレイヤーについての情報を提供します。項目ツールチップレイヤーのプロパティについて説明し、実装例も提供します。

Windows Forms | ヘルプ トピック