MESCIUS SPREAD for Windows Forms 15.0J > 開発者ガイド > スパークライン > 数式を使用してスパークラインの追加 > ゲージKPIスパークライン |
Spread for Wiformsは、KPI値に対してメトリクスのパフォーマンスを視覚化するために使用できるゲージKPIスパークラインを提供します。本機能は、管理作業の有効性を示したり、販売目標を提示したりするために使用します。
ゲージKPIスパークラインは以下の値でメトリクスを表示します。
Spread for Winformsは3種類のゲージKPIスパークラインをサポートします:円、縦棒、横棒。 GaugeKPISparkline関数のgaugeTypeオプションを使用してゲージKPIスパークラインの種類を指定できます。
ゲージKPIスパークラインの数式には、次の書式を使用します。
=GAUGEKPISPARKLINE (targetValue, currentValue, minValue, maxValue, [showLabel, targetValueLabel, currentValueLabel, minValueLabel, maxValueLabel, fontArray, minAngle, maxAngle, radiusRatio, gaugeType, colorRange])
ゲージKPIスパークラインの数式には、次のオプションを使用できます。
引数 | タイプ | 説明 |
---|---|---|
targetValue | 数値 | ゲージKPIスパークラインの目標値です。目標値は、minValueとmaxValueの間の値です。 |
currentValue | 数値 | ゲージKPIスパークラインの現在値です。現在値は、minValueとmaxValueの間の値です。 |
minValue | 数値 | ゲージKPIスパークラインの最小値です。minValueは、maxValueより低いです。 |
maxValue | 数値 | ゲージKPIスパークラインの最大値です。maxValueは、minValueより高いです。 |
showLabel 省略可能 |
ブール |
スパークラインで提供されるすべての値のラベルを表示するかどうかを指定します。
falseの場合、ラベルが表示されません。 trueの場合、セルの寸法に収まるラベルのみを表示します。セルには、グラフとラベルの両方を表示するのに十分な幅と高さが必要です。 デフォルト値はtrueです。 |
targetValueLabel 省略可能 |
文字列 |
目標値のラベルとして表示される文字列です。 デフォルト値は「targetValue」です。 |
currentValueLabel 省略可能 |
文字列 |
現在値のラベルとして表示される文字列です。 デフォルト値は「currentValue」です。 |
minValueLabel 省略可能 |
文字列 |
最小値のラベルとして表示される文字列です。 デフォルト値は「minValue」です。 |
maxValueLabel 省略可能 |
文字列 |
最大値のラベルとして表示される文字列です。 デフォルト値は「maxValue」です。 |
fontArray 省略可能 |
CalcArray |
配列には、4つのラベルタイプの文字列アイテムとしてフォント形式が含まれています。
showLabelオプションがtrueである必要があります。 |
minAngle 省略可能 |
数値 |
円型の最小角度値です。minAngleは、maxAngleより低いです。 角度値が時計の時刻に対しています。0は12時、-90は9時、90は3時、-180/180は6時です。 デフォルト値は「-90」です。 gaugeTypeオプションが0(円型)である必要があります。 |
maxAngle 省略可能 |
数値 |
円型の最大角度値です。maxAngleは、minAngleより高いです。 角度値が時計の時刻に対しています。0は12時、-90は9時、90は3時、-180/180は6時です。 デフォルト値は「90」です。 gaugeTypeオプションが0(円型)である必要があります。 |
radiusRatio 省略可能 |
数値 |
値は、内側の円の半径と外側の円の半径の比率として計算されます。外側の円の半径の値は、セルのサイズによって決定されます。 値の範囲は0から1です。デフォルト値は「0」です。 gaugeTypeオプションが0(円型)である必要があります。 |
gaugeType 省略可能 |
数値 |
KPIスパークラインの種類です。 0 - 円 デフォルト値は円です。 |
colorRange 省略可能 繰り返し可能 |
CalcArray |
指定値の間の色範囲。 {startValue, endValue, color_string} startValueは範囲の開始値であり、endValueは終了値です。color_stringは指定された2つの値の間の範囲の色です。 startValueはendValue未満である必要があり、両方の値はminValueとmaxValueの間にある必要があります。 minValueからmaxValueまでのデフォルトの色範囲は薄いグレー色で塗りつぶされます。 |
以下は、企業が年間売上高を監視したい場合の例です。ゲージKPIスパークラインを使用して、目標値と実際の値に対して収益、利益、および売上のメトリックを測定できます。これにより、データを効率的に視覚化し、意味のある控除を行うことができます。
C# |
コードのコピー
|
---|---|
// シートを取得します。 fpSpread1.Sheets.Count = 2; var sheet1 = fpSpread1.Sheets[0]; var sheet2 = fpSpread1.Sheets[1]; var worksheet1 = fpSpread1.Sheets[0].AsWorksheet(); var worksheet2 = fpSpread1.Sheets[1].AsWorksheet(); // データを設定します。 worksheet2.SetValue(0, 0, new object[,] { {"パラメータ", "目標", "現在", "最小", "最大" }, { "収益", 900, 1200, 0, 2000 }, { "利益", 1200, 1100, 0, 2000}, {"販売", 1600, 1800, 0, 2000} }); // GaugeKPISparkline数式を設定します。 worksheet1.Cells["A2"].Formula = "GAUGEKPISPARKLINE(Sheet2!B2,Sheet2!C2,Sheet2!D2,Sheet2!E2,TRUE,TEXT(Sheet2!B2/1000,\"¥0.0K\"),Sheet2!A2,TEXT(Sheet2!D2/1000,\"¥0.0K\"),TEXT(Sheet2!E2/1000,\"¥0.0K\"),,-90,90,0.4,0,{0,1200,\"#FFB2BD\"},{1200,1500,\"#FFDFB0\"},{1500,2000,\"#BCEAB4\"})"; worksheet1.Cells["B2"].Formula = "GAUGEKPISPARKLINE(Sheet2!B3,Sheet2!C3,Sheet2!D3,Sheet2!E3,TRUE,TEXT(Sheet2!B3/1000,\"¥0.0K\"),Sheet2!A3,TEXT(Sheet2!D3/1000,\"¥0.0K\"),TEXT(Sheet2!E3/1000,\"¥0.0K\"),,-90,90,0.4,0,{0,1200,\"#FFB2BD\"},{1200,1500,\"#FFDFB0\"},{1500,2000,\"#BCEAB4\"})"; worksheet1.Cells["C2"].Formula = "GAUGEKPISPARKLINE(Sheet2!B4,Sheet2!C4,Sheet2!D4,Sheet2!E4,TRUE,TEXT(Sheet2!B4/1000,\"¥0.0K\"),Sheet2!A4,TEXT(Sheet2!D4/1000,\"¥0.0K\"),TEXT(Sheet2!E4/1000,\"¥0.0K\"),,-90,90,0.4,0,{0,1200,\"#FFB2BD\"},{1200,1500,\"#FFDFB0\"},{1500,2000,\"#BCEAB4\"})"; |
Visual Basic |
コードのコピー
|
---|---|
' シートを取得します。 FpSpread1.Sheets.Count = 2 Dim sheet1 = FpSpread1.Sheets(0) Dim sheet2 = FpSpread1.Sheets(1) Dim worksheet1 = FpSpread1.Sheets(0).AsWorksheet() Dim worksheet2 = FpSpread1.Sheets(1).AsWorksheet() ' データを設定します。 worksheet2.SetValue(0, 0, New Object(,) { {"パラメータ", "目標", "現在", "最小", "最大" }, {"収益", 900, 1200, 0, 2000}, {"利益", 1200, 1100, 0, 2000}, {"販売", 1600, 1800, 0, 2000} }) ' GaugeKPISparkline数式を設定します。 worksheet1.Cells("A2").Formula = "GAUGEKPISPARKLINE(Sheet2!B2,Sheet2!C2,Sheet2!D2,Sheet2!E2,TRUE,TEXT(Sheet2!B2/1000,""¥0.0K""),Sheet2!A2,TEXT(Sheet2!D2/1000,""¥0.0K""),TEXT(Sheet2!E2/1000,""¥0.0K""),,-90,90,0.4,0,{0,1200,""#FFB2BD""},{1200,1500,""#FFDFB0""},{1500,2000,""#BCEAB4""})" worksheet1.Cells("B2").Formula = "GAUGEKPISPARKLINE(Sheet2!B3,Sheet2!C3,Sheet2!D3,Sheet2!E3,True,TEXT(Sheet2!B3/1000,""¥0.0K""),Sheet2!A3,TEXT(Sheet2!D3/1000,""¥0.0K""),TEXT(Sheet2!E3/1000,""¥0.0K""),,-90,90,0.4,0,{0,1200,""#FFB2BD""},{1200,1500,""#FFDFB0""},{1500,2000,""#BCEAB4""})" worksheet1.Cells("C2").Formula = "GAUGEKPISPARKLINE(Sheet2!B4,Sheet2!C4,Sheet2!D4,Sheet2!E4,True,TEXT(Sheet2!B4/1000,""¥0.0K""),Sheet2!A4,TEXT(Sheet2!D4/1000,""¥0.0K""),TEXT(Sheet2!E4/1000,""¥0.0K""),,-90,90,0.4,0,{0,1200,""#FFB2BD""},{1200,1500,""#FFDFB0""},{1500,2000,""#BCEAB4""})" |
可能な場合は、[ゲージKPIスパークラインの設定]ダイアログボックスでスパークラインの追加設定を設定することもできます。