ExcelScript.ConditionalRangeFont interface

包:

ExcelScript

此对象表示对象的字体属性 (字体样式、颜色等 ) 。

注解

示例

/**
 * This script applies cell value conditional formatting to a range.
 * Any value less than 60 will have the cell's fill color changed and the font made italic.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range to format.
  const selectedRange = workbook.getSelectedRange();

  // Add cell value conditional formatting.
  const cellValueConditionalFormatting =
    selectedRange.addConditionalFormat(ExcelScript.ConditionalFormatType.cellValue).getCellValue();

  // Create the condition, in this case when the cell value is less than 60.
  const rule: ExcelScript.ConditionalCellValueRule = {
    formula1: "60",
    operator: ExcelScript.ConditionalCellValueOperator.lessThan
  };
  cellValueConditionalFormatting.setRule(rule);

  // Set the format to apply when the condition is met.
  const format: ExcelScript.ConditionalRangeFormat = cellValueConditionalFormatting.getFormat();
  const fill: ExcelScript.ConditionalRangeFill = format.getFill();
  const font: ExcelScript.ConditionalRangeFont = format.getFont();
  fill.setColor("yellow");
  font.setItalic(true);
}

方法

clear()	重置字体格式。
getBold()	指定字体是否为粗体。
getColor()	文本颜色 (的 HTML 颜色代码表示形式，例如，#FF0000 表示红色) 。
getItalic()	指定字体是否为斜体。
getStrikethrough()	指定字体的删除线状态。
getUnderline()	应用于字体的下划线类型。 有关详细信息，请参阅 ExcelScript.ConditionalRangeFontUnderlineStyle。
setBold(bold)	指定字体是否为粗体。
setColor(color)	文本颜色 (的 HTML 颜色代码表示形式，例如，#FF0000 表示红色) 。
setItalic(italic)	指定字体是否为斜体。
setStrikethrough(strikethrough)	指定字体的删除线状态。
setUnderline(underline)	应用于字体的下划线类型。 有关详细信息，请参阅 ExcelScript.ConditionalRangeFontUnderlineStyle。

方法详细信息

clear()

重置字体格式。

clear(): void;

返回

void

getBold()

指定字体是否为粗体。

getBold(): boolean;

返回

boolean

getColor()

文本颜色 (的 HTML 颜色代码表示形式，例如，#FF0000 表示红色) 。

getColor(): string;

返回

string

getItalic()

指定字体是否为斜体。

getItalic(): boolean;

返回

boolean

getStrikethrough()

指定字体的删除线状态。

getStrikethrough(): boolean;

返回

boolean

getUnderline()

应用于字体的下划线类型。 有关详细信息，请参阅 ExcelScript.ConditionalRangeFontUnderlineStyle。

getUnderline(): ConditionalRangeFontUnderlineStyle;

返回

ExcelScript.ConditionalRangeFontUnderlineStyle

setBold(bold)

指定字体是否为粗体。

setBold(bold: boolean): void;

参数

bold

boolean

返回

void

setColor(color)

文本颜色 (的 HTML 颜色代码表示形式，例如，#FF0000 表示红色) 。

setColor(color: string): void;

参数

color

string

返回

void

setItalic(italic)

指定字体是否为斜体。

setItalic(italic: boolean): void;

参数

italic

boolean

返回

void

setStrikethrough(strikethrough)

指定字体的删除线状态。

setStrikethrough(strikethrough: boolean): void;

参数

strikethrough

boolean

返回

void

setUnderline(underline)

应用于字体的下划线类型。 有关详细信息，请参阅 ExcelScript.ConditionalRangeFontUnderlineStyle。

setUnderline(underline: ConditionalRangeFontUnderlineStyle): void;

参数

underline

ExcelScript.ConditionalRangeFontUnderlineStyle

返回

void