SpreadJS製品ヘルプ
GAUGEKPISPARKLINE
関数リファレンス > 関数の一覧 > スパークライン関数 > GAUGEKPISPARKLINE

この関数は、ゲージKPIスパークラインを表すために使用されるデータセットを返します。

書式

GAUGEKPISPARKLINE (targetValue, currentValue, minValue, maxValue, [showLabel, targetValueLabel, currentValueLabel, minValueLabel, maxValueLabel, fontArray, minAngle, maxAngle, radiusRatio, gaugeType, colorRange])

引数

引数 説明
targetValue ゲージKPIスパークラインの目標値です。目標値は、minValueとmaxValueの間の値です。
currentValue ゲージKPIスパークラインの現在値です。現在値は、minValueとmaxValueの間の値です。
minValue ゲージKPIスパークラインの最小値です。minValueは、maxValueより低いです。
maxValue ゲージKPIスパークラインの最大値です。maxValueは、minValueより高いです。
showLabel

(オプション)スパークラインで提供されるすべての値のラベルを表示するかどうかを指定します。

  • falseの場合、ラベルが表示されません。
  • trueの場合、セルの寸法に収まるラベルのみを表示します。セルには、グラフとラベルの両方を表示するのに十分な幅と高さが必要です。

デフォルト値はtrueです。

targetValueLabel (オプション)目標値のラベルとして表示される文字列です。デフォルト値はtargetValueです。
currentValueLabel (オプション)現在値のラベルとして表示される文字列です。デフォルト値はcurrentValueです。
mintValueLabel (オプション)最小値のラベルとして表示される文字列です。デフォルト値はminValueです。
maxValueLabel (オプション)最大値のラベルとして表示される文字列です。デフォルト値はmaxValueです。
fontArray (オプション)配列には、4つのラベルタイプの文字列アイテムとしてフォント形式が含まれています。
  • 目標値のラベル:デフォルト値は「16px Calibri」です。
  • 現在値のラベル:デフォルト値は「bold 22px Calibri」です。
  • 最小値・最大値のラベル:デフォルト値は「12px Calibri」です。

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 - 円
1 - 縦棒
2 - 横棒

デフォルト値は円です。

colorRange

(オプション)指定値の間の色範囲。startValue, endValue, color_string.

startValueは範囲の開始値であり、endValueは終了値です。color_stringは指定された2つの値の間の範囲の色です。

startValueendValue未満である必要があり、両方の値はminValueとmaxValueの間にある必要があります。

minValueからmaxValueまでのデフォルトの色範囲は薄いグレー色で塗りつぶされます。

データ型

スパークラインを返します。

サンプル

sheet1.setFormula(1, 0, '=GAUGEKPISPARKLINE(Sheet2!B2,Sheet2!C2,Sheet2!D2,Sheet2!E2,TRUE,TEXT(Sheet2!B3/1000,"$0.0K"),Sheet2!A2,TEXT(Sheet2!D2/1000,"$0.0K"),TEXT(Sheet2!E2/1000,"$0.0K"),{"normal normal 11pt Calibri","normal bold 16pt Calibri","normal normal 9pt Calibri","normal normal 9pt Calibri"},-90,90,0.4,0,{0,1200,"#FFB2BD"},{1200,1500,"#FFDFB0"},{1500,2000,"#BCEAB4"})');