ActiveReports for .NET 18.0J
Sparkline
ActiveReportsユーザーガイド > 概念 > ページレポート/RDLレポートの概念 > ページレポート/RDLレポートのレポートコントロール > Sparkline

Sparkline(スパークライン)コントロールは、データの傾向を小さなグラフに表示するコントロールです。スパークラインは、最新の値をスケール上に右端のデータポイントとして表示して以前の値と比較し、時間の経過でデータの一般的な変更内容を表示することができます。スパークラインは周囲のテキストと同様の高さと、14文字まで表示可能な幅を持ち、ダッシュボード、レポートをはじめとする文書によく適合します。

スパークラインには以下の種類があります。

種類 解説
Line Lineスパークラインは、広く金融·経済データ分析で使用され、連続的なデータの流れに基づいています。通貨の為替レート、価格の変化などのデータを表示する場合に使用することができます。
Columns Columnsスパークラインは、スポーツのスコア、レジの領収書など、以前の値と現在の値が直接関連しないデータに使用することができます。この場合は、Lineスパークラインのように連続的なデータの流れではなく、離散データ点で操作します。
Whiskers Whiskersスパークラインは、データを「勝/敗/引き分け」(例えば、ゲームの場合)または「True/False」(たとえば、販売目標、温度変化)の形式で表示することができます。 この種類はColumnスパークラインとよく似ていますが、引き分け(0)の場合は違う方法で描画します。Whiskersスパークラインでは、ベースラインより上に表示されるバーは正の値、下に表示されるバーは負の値、ベースラインはゼロ値を表します。
Area AreaスパークラインはLineスパークラインとよく似ていますが、ラインの下のスペースが影付きで表示されます。
StackedBar StackedBarスパークラインは、1本の横棒として表示され、個別の幅と色を持った複数のセグメントで構成されています。各セグメントの幅は全体に対して占める割合を表し、最も幅の広いセグメントは最大値であることを意味します。個々の値は、その色の明るさによって識別されます。

主なプロパティ

Sparklineコントロールをクリックすると、[プロパティ]ウィンドウで次のプロパティを設定できます。

プロパティ 解説
AccessibleDescription アクセシビリティ支援アプリが使う代替テキストを設定します。レポートをエクスポートする時に、このプロパティはPDFで「代替テキスト」、HTMLで「alt」タグとして扱われます。
DataSetName スパークラインに使用するデータセットを指定します。
DataSetParameters データセットに渡すパラメータのコレクションを指定します。
FillStyle スパークラインのデータの外観を設定します。None、LeftRight、TopBottom、Center、DiagonalLeft、DiagonalRight、HorizontalCenter、VerticalCenterから選択できます。スパークラインの線に設定する塗りつぶしの色も選択できます。
Filters 式、演算子、値を指定して、新しいフィルタを追加します。
LineStyle 線種がLineの場合、線の太さを設定する値をポイント単位で入力します。線に使用する色を、カラーピッカー、カスタム色、またはWebカラーから選択します。
Location コンテナを基準としたスパークラインの左上端の位置をポイント単位で入力します。
MarkerColor 終点マーカーの色を選択するか、[<式>]オプションを選択して式エディタを開き、.NETカラーに評価される式を作成します。
MarkerVisibility 線種がLineの場合、スパークライン上の終点でマーカーを表示するかどうかを選択します。
MaximumColumnWidth スパークラインの各列が占めるスペースの量を設定します。
Range ウォール範囲の下限と上限を定義する値または式を入力します。Backdropを使用すると、ウォール範囲のグラデーションの種類と色を選択できます。
RangeVisibility 範囲ウォールを表示するかどうかを示します。
SeriesValue シリーズの値に使用する式を入力します。
Size スパークラインの幅と高さを設定します。
SparklineType スパークラインの種類を選択します。Line、Columns、Whiskers、Area、StackedBarから選択します。

プロパティ設定ダイアログ

Sparklineレポートコントロールのプロパティは、プロパティ設定ダイアログで指定することができます。このダイアログを表示するには、レポート上のSparklineコントロールを選択した状態で、[プロパティ]ウィンドウ内にある[プロパティ設定ダイアログ]のリンクをクリックします。表示される[Sparkline]ダイアログが、Sparklineコントロールのプロパティ設定ダイアログにあたります。

[Sparkline]ダイアログでは、以下の各ページを使用してSparklineコントロールのプロパティを設定することができます。

[全般]

[名前] : まだレポートに使用されていない一意のスパークラインの名前を入力します。この名前はコード内に呼び出すことができます。

[データ]

[値]: スパークラインの値として使用する式を入力します。

[名前]: まだレポートに使用されていない一意のスパークラインの名前を入力します。この名前はコード内に呼び出すことができます。また、名前を入力しないと自動的に名前が付けられます。

[グループ化の条件]: データをグループ化するために使用する式を入力します。式エディタを開いてデータセットからフィールドを選択することができます。

[詳細のグループ化]: 詳細行の値を繰り返したくない場合に、グループ化に使用する式を入力します。式エディタを開いてデータセットからフィールドを選択することができます。

[親グループ]: 再帰階層の場合使用します。親グループとして使用する式を入力します。

[外観]

[種類]: 「Line」、「Columns」、「Whiskers」、「Area」、「StackedBar」の値から選択します。これらの各種類は、独自の外観プロパティを提供しています。種類を選択すると、その外観プロパティが表示されます。

Lineスパークラインの外観プロパティ

終点のマーカーを表示する: スパークライン上の終点でマーカーを表示する場合に選択します。

マーカー色: 終点のマーカーのため色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

[線種] 

色: 線の色を示すカラーを選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

太さ: 線の太さを設定する値をポイント単位で入力します。

壁面範囲を有効にする: スパークラインに範囲ウォールを表示する場合、このチェックボックスを選択します。このオプションを選択することで、ページの他のオプションが使用可能になります。

下限ライン: 範囲ウォールの下限を示す値、または式を入力します。

上限ライン: 範囲ウォールの上限を示す値、または式を入力します。

[壁面の背景]

背景色: ウォール範囲を示すカラーを選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

グラデーション: 背景に使用するグラデーションの種類を「None」、「LeftRight」、「TopBottom」、「Center」、「DiagonalLeft」、「DiagonalRight」、「HorizontalCenter」、「VerticalCenter」の値から選択します。

背景色(グラデーション): 範囲ウォールグラデーションの終了に使用する色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

Columnスパークラインの外観プロパティ

背景色: スパークラインに塗りつぶす色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

棒の最大幅: スパークラインの棒の最大幅を選択します。空白の場合、全ての列はグラフのサイズに合わせて表示します。

壁面範囲を有効にする: スパークラインに範囲ウォールを表示する場合、このチェックボックスを選択します。このオプションを選択することで、ページの他のオプションが使用可能になります。

下限ライン: 範囲ウォールの下限を示す値、または式を入力します。

上限ライン: 範囲ウォールの上限を示す値、または式を入力します。

[壁面の背景]

背景色: ウォール範囲を示すカラーを選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

グラデーション: グラデーションの種類を「None」、「LeftRight」、「TopBottom」、「Center」、「DiagonalLeft」、「DiagonalRight」、「HorizontalCenter」、「VerticalCenter」の値から選択します。

背景色(グラデーション): 範囲ウォールグラデーションの終了に使用する色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

Whiskersスパークラインの外観プロパティ

背景色: スパークラインを塗りつぶす色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

棒の最大幅: スパークラインの棒の最大幅を選択します。空白の場合、全ての列はグラフのサイズに合わせて表示します。

壁面範囲を有効にする: スパークラインに範囲ウォールを表示する場合、このチェックボックスを選択します。このオプションを選択することで、ページの他のオプションが使用可能になります。

下限ライン: 範囲ウォールの下限を示す値、または式を入力します。

上限ライン: 範囲ウォールの上限を示す値、または式を入力します。

[壁面の背景]

背景色: ウォール範囲を示すカラーを選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

グラデーション: グラデーションの種類を「None」、「LeftRight」、「TopBottom」、「Center」、「DiagonalLeft」、「DiagonalRight」、「HorizontalCenter」、「VerticalCenter」の値から選択します。

背景色(グラデーション): 範囲ウォールグラデーションの終了に使用する色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

Areaスパークラインの外観プロパティ

背景色: スパークラインに塗りつぶす色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

壁面範囲を有効にする: スパークラインに範囲ウォールを表示する場合、このチェックボックスを選択します。このオプションを選択することで、ページの他のオプションが使用可能になります。

下限ライン: 範囲ウォールの下限を示す値または式を入力します。

上限ライン: 範囲ウォールの上限を示す値または式を入力します。

[壁面の背景]

背景色: ウォール範囲を示すカラーを選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

グラデーション: グラデーションの種類を「None」、「LeftRight」、「TopBottom」、「Center」、「DiagonalLeft」、「DiagonalRight」、「HorizontalCenter」、「VerticalCenter」の値から選択します。

背景色(グラデーション): 範囲ウォールグラデーションの終了に使用する色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。

StackedBarスパークラインの外観プロパティ

背景色: 積層棒のベース色に使用する色を選択するか、<式...>オプションで[式エディタ]を開き、.NETの色を評価する式を作成します。積層棒のほかの色はベース色によって計算されます。

[表示]

[表示の初期実行]

[他のレポートアイテムの状態に応じて表示を切り替える]: 他のレポートアイテムに隣接する切り替え画像を表示するには、このチェックボックスをオンにします。その下のドロップダウンが有効になり、スパークラインの表示を切り替えるためのTextBoxコントロールを指定します。

[ナビゲーション]

[見出しマップラベル]: 目次(見出しマップ)でこのアイテムを表すためのラベルとして使用する式を入力します。

[ブックマークID]: このスパークラインのロケータとして使用する式を入力します。次に、[ブックマークに移動]アクションを使用して、別のレポートコントロールからこの項目にブックマークリンクを提供することが可能となります。

[フィルタ]

コレクションに新しいフィルタを追加するには、次の3つの値を設定する必要があります。

式: フィルタリングに使用する式を入力します。

演算子: フィルタリングの方法を次の演算子から選択します。

値: 選択された演算子に基づいて左側の式と比較する値を入力します。Between演算子を選択した場合、2つの値ボックスが有効になります。In演算子を選択した場合、多くの値を入力することができます。

[並べ替え]

[追加](+)ボタン記号をクリックして並べ替えの新しい式を入力します。[削除](X)ボタンを使用して削除します。

表示される[式]ボックスで、グループ内でのデータの並べ替えに使用する式を入力します。また、[方向]オプションでソート式の方法を「昇順」、「降順」のいずれかに設定します。

 

[データ出力]

要素名:このスパークラインのXML出力に使用する名前を入力します。

出力: XML出力にこのスパークラインを含めるかどうかを決定するため、[自動]、[する]、[しない]、[データのみ]の値から選択します。[自動]を選択すると、スパークラインの内容がエクスポートされます。


Webデザイナ

Webデザイナに表示されるプロパティは、以下の通りです。

Sparkline

カテゴリ プロパティ 説明
全般 名前​ 名前を設定します。
種類 スパークラインの種類を設定します。
値 表示するデータを設定します。
位置とサイズ 左 左位置を設定します。
上 上位置を設定します。
幅 幅を設定します。
高さ 高さを設定します。
レイアウト スタイル スタイル名を設定します。
レイヤー名 含まれるレイヤーの名前を設定します。
Zインデックス レポートアイテム同士の重なりの優先順位を設定します。
グループ 名前​ グループの名前を設定します。
式 データをグループ化するための式を設定します。
親グループ 親グループを設定します。
ラベル 目次に表示するラベルを設定します。
線 色 線の色を設定します。
太さ 線の太さを設定します。
マーカーの色 マーカーの色を設定します。
マーカーの表示 マーカーを表示するかどうかを設定します。
列 最大幅 各データを表示する最大の幅を設定します。
塗りつぶし 色 塗りつぶしの色を設定します。
グラデーションの種類 グラデーションの種類を設定します。
グラデーションの終了色 グラデーションの終了色を設定します。
レンジ 下限 レンジの下限の値を設定します。
上限 レンジの上限の値を設定します。
色 塗りつぶしの色を設定します。
グラデーションの種類 グラデーションの種類を設定します。
グラデーションの終了色 グラデーションの終了色を設定します。
表示 レンジを表示するかどうかを設定します。
表示 非表示 非表示にするかどうかを設定します。
トグルスイッチにする項目 表示/非表示の切り替えに使うテキストボックスの名前を設定します。
データ 要素名 データ出力で使用する要素の名前を設定します。
要素出力 データ出力でデータを出力するかどうかを設定します。
データセット 表示するデータセットを設定します。
データセットパラメータ データセットに渡すパラメータを設定します。
並べ替えの式 並べ替えの式を設定します。
フィルタ データを抽出するフィルタを設定します。
その他 ツールチップ カーソルを合わせたときに表示するテキストを設定します。
ラベル 目次に表示するラベルを設定します。
ブックマークID ブックマークのIDを設定します。
アクセシビリティ アクセシビリティのための代替テキストを設定します。

関連トピック