このトピックは、コード例を示して、 UltraSparkline™ タイプを定義する方法を説明します。このスパークライン タイプの要件は特殊なため、Win/Loss 型の指定については個々のセクションで説明します。
以下の表に、このトピックを理解するための前提条件として求められるトピックをリストします。
UltraSparkline コントロールは、以下のタイプのスパークラインをサポートしています。
折れ線
エリア
柱状
Win/Loss
タイプは DisplayType プロパティの設定により定義されます。 DisplayType プロパティが指定されていない場合は、既定では Line 型が表示されます。
以下の表は、スパークライン タイプとそれらを構成するプロパティ設定の関係を示しています。
以下のスクリーンショットは、以下の設定で定義されたスパークラインを示します。
以下のコードは、Sparkline の表示タイプを Column に設定するコードを示しています。
C# の場合:
this.UltraSparkline1.DisplayType = SparklineDisplayType.Column;Visual Basic の場合:
Me.UltraSparkline1.DisplayType = SparklineDisplayType.ColumnWin/Loss 型は、柱状チャート タイプです。ここでは、各列の値はデータ セットの正の最大値 (正の値の場合) または負の最小値 (負の最小値の場合) に等しくなり、ウィンまたはロス (または似たような相反する概念) を意味することが多いです。Win/Loss チャートを正しく表示するには、データ セットには正の値と負の値がなければなりません。
Win/Loss 型が (数値のコレクションにバインドできる) Line 型 など他のタイプと同じデータにバインドされている場合、 UltraSparkline はコレクションから最高値と最低値という 2 つの値を選択し、それらの値に基づいてスパークラインをレンダリングします。
たとえば、次のようにすべてのスパークライン タイプが同じデータ ソースにバインドされている場合:
Win/Loss 型は、データ ソース全体から最高値 (5) および最低値 (-3) という 2 つの値のみ選択し、最高値と同一のすべての正のデータ ポイントと最低値と同一のすべての負のデータ ポイントをプロットします。
以下の表は、Win/Loss 型の Sparkline をそれを指定するプロパティ設定に設定するプロパティ設定を示しています。
以下のスクリーンショットは、以下の設定の結果、スパークラインがどのように表示されるかを示しています。
以下のコードは、UltraSparkline の表示タイプを WinLoss に設定するコードを示しています。
C# の場合:
this.UltraSparkline1.DisplayType = SparklineDisplayType.WinLoss;Visual Basic の場合:
Me.UltraSparkline1.DisplayType = SparklineDisplayType.WinLoss以下のトピックでは、このトピックに関連する情報を提供しています。