ExcelScript.DataBarConditionalFormat interface

リファレンス

パッケージ:: ExcelScript

Excel の条件付きデータバーの種類を表します。

注釈

例

/**
 * This script creates data bar conditional formatting on the selected range.
 * The scale of the data bar goes from 0 to 1000.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the selected range.
  const selected = workbook.getSelectedRange();
  
  // Create new conditional formatting on the range.
  const format = selected.addConditionalFormat(ExcelScript.ConditionalFormatType.dataBar);
  const dataBarFormat: ExcelScript.DataBarConditionalFormat = format.getDataBar();

  // Set the lower bound of the data bar formatting to be 0.
  const lowerBound: ExcelScript.ConditionalDataBarRule = {
    type: ExcelScript.ConditionalFormatRuleType.number,
    formula: "0"
  };
  dataBarFormat.setLowerBoundRule(lowerBound);

  // Set the upper bound of the data bar formatting to be 1000.
  const upperBound: ExcelScript.ConditionalDataBarRule = {
    type: ExcelScript.ConditionalFormatRuleType.number,
    formula: "1000"
  };
  dataBarFormat.setUpperBoundRule(upperBound);
}

メソッド

getAxisColor()	軸の線の色を表す HTML 色コード(例: "FFA500")、または名前付き HTML カラー (例: "オレンジ") として #RRGGBB。軸が存在しない場合、または設定されていない場合、値は "" (空の文字列) です。
getAxisFormat()	Excel データバーの軸の決定方法を表します。
getBarDirection()	データバーグラフィックの基になる方向を指定します。
getLowerBoundRule()	データバーの下限 (および該当する場合はその計算方法) を構成するルール。 `ConditionalDataBarRule` オブジェクトは JSON オブジェクトとして設定する必要があります (`x.lowerBoundRule.formula = ...`ではなく`x.lowerBoundRule = {...}`を使用します)。
getNegativeFormat()	Excel データバーの軸の左側にあるすべての値を表します。
getPositiveFormat()	Excel データバーの軸の右側にあるすべての値を表します。
getShowDataBarOnly()	`true` 場合は、データバーが適用されているセルから値を非表示にします。
getUpperBoundRule()	データバーの上限値 (および該当する場合はその計算方法) を構成するルール。 `ConditionalDataBarRule` オブジェクトは JSON オブジェクトとして設定する必要があります (`x.upperBoundRule.formula = ...`ではなく`x.upperBoundRule = {...}`を使用します)。
setAxisColor(axisColor)	軸の線の色を表す HTML 色コード(例: "FFA500")、または名前付き HTML カラー (例: "オレンジ") として #RRGGBB。軸が存在しない場合、または設定されていない場合、値は "" (空の文字列) です。
setAxisFormat(axisFormat)	Excel データバーの軸の決定方法を表します。
setBarDirection(barDirection)	データバーグラフィックの基になる方向を指定します。
setLowerBoundRule(lowerBoundRule)	データバーの下限 (および該当する場合はその計算方法) を構成するルール。 `ConditionalDataBarRule` オブジェクトは JSON オブジェクトとして設定する必要があります (`x.lowerBoundRule.formula = ...`ではなく`x.lowerBoundRule = {...}`を使用します)。
setShowDataBarOnly(showDataBarOnly)	`true` 場合は、データバーが適用されているセルから値を非表示にします。
setUpperBoundRule(upperBoundRule)	データバーの上限値 (および該当する場合はその計算方法) を構成するルール。 `ConditionalDataBarRule` オブジェクトは JSON オブジェクトとして設定する必要があります (`x.upperBoundRule.formula = ...`ではなく`x.upperBoundRule = {...}`を使用します)。

メソッドの詳細

getAxisColor()

軸の線の色を表す HTML 色コード(例: "FFA500")、または名前付き HTML カラー (例: "オレンジ") として #RRGGBB。軸が存在しない場合、または設定されていない場合、値は "" (空の文字列) です。

getAxisColor(): string;

戻り値

string

getAxisFormat()

Excel データバーの軸の決定方法を表します。

getAxisFormat(): ConditionalDataBarAxisFormat;

戻り値

ExcelScript.ConditionalDataBarAxisFormat

getBarDirection()

データバーグラフィックの基になる方向を指定します。

getBarDirection(): ConditionalDataBarDirection;

戻り値

ExcelScript.ConditionalDataBarDirection

getLowerBoundRule()

データバーの下限 (および該当する場合はその計算方法) を構成するルール。 ConditionalDataBarRule オブジェクトは JSON オブジェクトとして設定する必要があります (x.lowerBoundRule.formula = ...ではなくx.lowerBoundRule = {...}を使用します)。

getLowerBoundRule(): ConditionalDataBarRule;

戻り値

ExcelScript.ConditionalDataBarRule

getNegativeFormat()

Excel データバーの軸の左側にあるすべての値を表します。

getNegativeFormat(): ConditionalDataBarNegativeFormat;

戻り値

ExcelScript.ConditionalDataBarNegativeFormat

getPositiveFormat()

Excel データバーの軸の右側にあるすべての値を表します。

getPositiveFormat(): ConditionalDataBarPositiveFormat;

戻り値

ExcelScript.ConditionalDataBarPositiveFormat

getShowDataBarOnly()

true 場合は、データバーが適用されているセルから値を非表示にします。

getShowDataBarOnly(): boolean;

戻り値

boolean

getUpperBoundRule()

データバーの上限値 (および該当する場合はその計算方法) を構成するルール。 ConditionalDataBarRule オブジェクトは JSON オブジェクトとして設定する必要があります (x.upperBoundRule.formula = ...ではなくx.upperBoundRule = {...}を使用します)。

getUpperBoundRule(): ConditionalDataBarRule;

戻り値

ExcelScript.ConditionalDataBarRule

setAxisColor(axisColor)

setAxisColor(axisColor: string): void;

パラメーター

axisColor: string

戻り値

void

setAxisFormat(axisFormat)

Excel データバーの軸の決定方法を表します。

setAxisFormat(axisFormat: ConditionalDataBarAxisFormat): void;

パラメーター

axisFormat: ExcelScript.ConditionalDataBarAxisFormat

戻り値

void

setBarDirection(barDirection)

データバーグラフィックの基になる方向を指定します。

setBarDirection(barDirection: ConditionalDataBarDirection): void;

パラメーター

barDirection: ExcelScript.ConditionalDataBarDirection

戻り値

void

setLowerBoundRule(lowerBoundRule)

setLowerBoundRule(lowerBoundRule: ConditionalDataBarRule): void;

パラメーター

lowerBoundRule: ExcelScript.ConditionalDataBarRule

戻り値

void

setShowDataBarOnly(showDataBarOnly)

true 場合は、データバーが適用されているセルから値を非表示にします。

setShowDataBarOnly(showDataBarOnly: boolean): void;

パラメーター

showDataBarOnly: boolean

戻り値

void

setUpperBoundRule(upperBoundRule)

setUpperBoundRule(upperBoundRule: ConditionalDataBarRule): void;

パラメーター

upperBoundRule: ExcelScript.ConditionalDataBarRule

戻り値

void

次の方法で共有

ExcelScript.DataBarConditionalFormat interface

注釈

例

メソッド

メソッドの詳細

getAxisColor()

戻り値

getAxisFormat()

戻り値

getBarDirection()

戻り値

getLowerBoundRule()

戻り値

getNegativeFormat()

戻り値

getPositiveFormat()

戻り値

getShowDataBarOnly()

戻り値

getUpperBoundRule()

戻り値

setAxisColor(axisColor)

パラメーター

戻り値

setAxisFormat(axisFormat)

パラメーター

戻り値

setBarDirection(barDirection)

パラメーター

戻り値

setLowerBoundRule(lowerBoundRule)

パラメーター

戻り値

setShowDataBarOnly(showDataBarOnly)

パラメーター

戻り値

setUpperBoundRule(upperBoundRule)

パラメーター

戻り値

その他のリソース