バージョン

UltraSparkline タイプの定義

トピックの概要

目的

このトピックは、コード例を示して、 UltraSparkline™ タイプを定義する方法を説明します。このスパークライン タイプの要件は特殊なため、Win/Loss 型の指定については個々のセクションで説明します。

前提条件

以下の表に、このトピックを理解するための前提条件として求められるトピックをリストします。

トピック 目的

このトピックは、 UltraSparkline コントロールの概要、その利点、およびサポートされるチャート タイプを提供します。

このトピックは、コード例を示して、 UltraSparkline でヒントを構成し、カスタマイズする方法を説明します。

Sparkline タイプの定義

概要

UltraSparkline コントロールは、以下のタイプのスパークラインをサポートしています。

  • 折れ線

  • エリア

  • 柱状

  • Win/Loss

タイプは DisplayType プロパティの設定により定義されます。 DisplayType プロパティが指定されていない場合は、既定では Line 型が表示されます。

プロパティ設定

以下の表は、スパークライン タイプとそれらを構成するプロパティ設定の関係を示しています。

UltraSparkline タイプ DisplayType プロパティを以下に設定:

Line

Area

Column

WinLoss

以下のスクリーンショットは、以下の設定で定義されたスパークラインを示します。

プロパティ

Column

Define Sparkline Types 1.png

コード

以下のコードは、Sparkline の表示タイプを Column に設定するコードを示しています。

C# の場合:

this.UltraSparkline1.DisplayType = SparklineDisplayType.Column;

Visual Basic の場合:

Me.UltraSparkline1.DisplayType = SparklineDisplayType.Column

Win/Loss 型のスパークラインの定義

概要

Win/Loss 型は、柱状チャート タイプです。ここでは、各列の値はデータ セットの正の最大値 (正の値の場合) または負の最小値 (負の最小値の場合) に等しくなり、ウィンまたはロス (または似たような相反する概念) を意味することが多いです。Win/Loss チャートを正しく表示するには、データ セットには正の値と負の値がなければなりません。

Win/Loss 型が (数値のコレクションにバインドできる) Line 型 など他のタイプと同じデータにバインドされている場合、 UltraSparkline はコレクションから最高値と最低値という 2 つの値を選択し、それらの値に基づいてスパークラインをレンダリングします。

たとえば、次のようにすべてのスパークライン タイプが同じデータ ソースにバインドされている場合:

レコード

レコード 1

2

レコード 2

5

レコード 3

-1

レコード 4

4

レコード 5

-3

Win/Loss 型は、データ ソース全体から最高値 (5) および最低値 (-3) という 2 つの値のみ選択し、最高値と同一のすべての正のデータ ポイントと最低値と同一のすべての負のデータ ポイントをプロットします。

プロパティ設定

以下の表は、Win/Loss 型の Sparkline をそれを指定するプロパティ設定に設定するプロパティ設定を示しています。

以下を行うために: プロパティ 次に設定

Sparkline タイプを Win/Loss に設定する

WinLoss

以下のスクリーンショットは、以下の設定の結果、スパークラインがどのように表示されるかを示しています。

プロパティ

WinLoss

sparkline overview 4.png

コード

以下のコードは、UltraSparkline の表示タイプを WinLoss に設定するコードを示しています。

C# の場合:

this.UltraSparkline1.DisplayType = SparklineDisplayType.WinLoss;

Visual Basic の場合:

Me.UltraSparkline1.DisplayType = SparklineDisplayType.WinLoss

関連コンテンツ

トピック

以下のトピックでは、このトピックに関連する情報を提供しています。

トピック 目的

このトピックは、 UltraSparkline コントロールの概要、その利点、およびサポートされるチャート タイプを提供します。

このトピックは、コード例を示して、 UltraSparkline でヒントを構成し、カスタマイズする方法を説明します。

このトピックは、 UltraSparkline コントロールの主なプロパティを説明します。