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()	返回格式对象，该对象封装条件格式的字体、填充、边框和其他属性。
getRule()	顶部/底部条件格式的条件。
setRule(rule)	顶部/底部条件格式的条件。

方法详细信息

getFormat()

返回格式对象，该对象封装条件格式的字体、填充、边框和其他属性。

getFormat(): ConditionalRangeFormat;

返回

ExcelScript.ConditionalRangeFormat

getRule()

顶部/底部条件格式的条件。

getRule(): ConditionalTopBottomRule;

返回

ExcelScript.ConditionalTopBottomRule

setRule(rule)

顶部/底部条件格式的条件。

setRule(rule: ConditionalTopBottomRule): void;

参数

rule

ExcelScript.ConditionalTopBottomRule

返回

void