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)

パラメーター

戻り値

フィードバック

その他のリソース