ExcelScript.TopBottomConditionalFormat interface

パッケージ:

ExcelScript

上下の条件付き書式を表します。

注釈

例

/**
 * This sample applies conditional formatting to the currently used range in the worksheet. 
 * The conditional formatting is a green fill for the top 10% of values.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get the used range in the worksheet.
  let range = selectedSheet.getUsedRange();

  // Set the fill color to green for the top 10% of values in the range.
  let conditionalFormat = range.addConditionalFormat(ExcelScript.ConditionalFormatType.topBottom)
  conditionalFormat.getTopBottom().getFormat().getFill().setColor("green");
  conditionalFormat.getTopBottom().setRule({
    rank: 10, /* The percentage threshold. */
    type: ExcelScript.ConditionalTopBottomCriterionType.topPercent /* The type of the top/bottom condition. */
  });
}

メソッド

getFormat()	条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する format オブジェクトを返します。
getRule()	上/下の条件付き書式の条件。
setRule(rule)	上/下の条件付き書式の条件。

メソッドの詳細

getFormat()

条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する format オブジェクトを返します。

getFormat(): ConditionalRangeFormat;

戻り値

ExcelScript.ConditionalRangeFormat

getRule()

上/下の条件付き書式の条件。

getRule(): ConditionalTopBottomRule;

戻り値

ExcelScript.ConditionalTopBottomRule

setRule(rule)

上/下の条件付き書式の条件。

setRule(rule: ConditionalTopBottomRule): void;

パラメーター

rule

ExcelScript.ConditionalTopBottomRule

戻り値

void