ExcelScript.ConditionalDataBarPositiveFormat interface

パッケージ:

ExcelScript

データ バーの正の側の条件付き書式を表します。

注釈

例

/**
 * This script applies data bar conditional formatting to a range.
 * It sets the data bar colors to be green when positive and red when negative.
 */
function main(workbook: ExcelScript.Workbook) {
    // Get the "Sales" data column range in a table named "SalesTable".
    const table = workbook.getTable("SalesTable");
    const salesRange = table.getColumnByName("Sales").getRangeBetweenHeaderAndTotal();

    // Add data bar conditional formatting to the range.
    const cf = salesRange.addConditionalFormat(ExcelScript.ConditionalFormatType.dataBar);

    // Have the bar show green when positive and red when negative. 
    const dataBarConditionalFormat = cf.getDataBar();
    const positiveFormat: ExcelScript.ConditionalDataBarPositiveFormat = dataBarConditionalFormat.getPositiveFormat();
    positiveFormat .setFillColor("green");
    const negativeFormat: ExcelScript.ConditionalDataBarNegativeFormat = dataBarConditionalFormat.getNegativeFormat();
    negativeFormat.setFillColor("red");
}

メソッド

getBorderColor()	境界線の色を表す HTML カラー コードは、#RRGGBB 形式 (例: "FFA500") または名前付き HTML カラー (例: "オレンジ") として表されます。 罫線が存在しない場合、または設定されていない場合、値は "" (空の文字列) です。
getFillColor()	塗りつぶしの色を表す HTML カラー コードは、#RRGGBB 形式 (例: "FFA500") または名前付き HTML 色 (例: "オレンジ") として表されます。
getGradientFill()	データ バーにグラデーションがあるかどうかを指定します。
setBorderColor(borderColor)	境界線の色を表す HTML カラー コードは、#RRGGBB 形式 (例: "FFA500") または名前付き HTML カラー (例: "オレンジ") として表されます。 罫線が存在しない場合、または設定されていない場合、値は "" (空の文字列) です。
setFillColor(fillColor)	塗りつぶしの色を表す HTML カラー コードは、#RRGGBB 形式 (例: "FFA500") または名前付き HTML 色 (例: "オレンジ") として表されます。
setGradientFill(gradientFill)	データ バーにグラデーションがあるかどうかを指定します。

メソッドの詳細

getBorderColor()

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

getBorderColor(): string;

戻り値

string

getFillColor()

塗りつぶしの色を表す HTML カラー コードは、#RRGGBB 形式 (例: "FFA500") または名前付き HTML 色 (例: "オレンジ") として表されます。

getFillColor(): string;

戻り値

string

getGradientFill()

データ バーにグラデーションがあるかどうかを指定します。

getGradientFill(): boolean;

戻り値

boolean

setBorderColor(borderColor)

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

setBorderColor(borderColor: string): void;

パラメーター

borderColor

string

戻り値

void

setFillColor(fillColor)

塗りつぶしの色を表す HTML カラー コードは、#RRGGBB 形式 (例: "FFA500") または名前付き HTML 色 (例: "オレンジ") として表されます。

setFillColor(fillColor: string): void;

パラメーター

fillColor

string

戻り値

void

setGradientFill(gradientFill)

データ バーにグラデーションがあるかどうかを指定します。

setGradientFill(gradientFill: boolean): void;

パラメーター

gradientFill

boolean

戻り値

void