Partager via


ExcelScript.ConditionalRangeFont interface

Cet objet représente les attributs de police (style de police, couleur, etc.) d’un objet.

Remarques

Exemples

/**
 * 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);
}

Méthodes

clear()

Réinitialise les formats de police.

getBold()

Spécifie si la police est en gras.

getColor()

Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge).

getItalic()

Spécifie si la police est en italique.

getStrikethrough()

Spécifie le status barré de la police.

getUnderline()

Type de soulignement appliqué à la police. Pour plus d’informations, consultez ExcelScript.ConditionalRangeFontUnderlineStyle .

setBold(bold)

Spécifie si la police est en gras.

setColor(color)

Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge).

setItalic(italic)

Spécifie si la police est en italique.

setStrikethrough(strikethrough)

Spécifie le status barré de la police.

setUnderline(underline)

Type de soulignement appliqué à la police. Pour plus d’informations, consultez ExcelScript.ConditionalRangeFontUnderlineStyle .

Détails de la méthode

clear()

Réinitialise les formats de police.

clear(): void;

Retours

void

getBold()

Spécifie si la police est en gras.

getBold(): boolean;

Retours

boolean

getColor()

Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge).

getColor(): string;

Retours

string

getItalic()

Spécifie si la police est en italique.

getItalic(): boolean;

Retours

boolean

getStrikethrough()

Spécifie le status barré de la police.

getStrikethrough(): boolean;

Retours

boolean

getUnderline()

Type de soulignement appliqué à la police. Pour plus d’informations, consultez ExcelScript.ConditionalRangeFontUnderlineStyle .

getUnderline(): ConditionalRangeFontUnderlineStyle;

Retours

setBold(bold)

Spécifie si la police est en gras.

setBold(bold: boolean): void;

Paramètres

bold

boolean

Retours

void

setColor(color)

Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge).

setColor(color: string): void;

Paramètres

color

string

Retours

void

setItalic(italic)

Spécifie si la police est en italique.

setItalic(italic: boolean): void;

Paramètres

italic

boolean

Retours

void

setStrikethrough(strikethrough)

Spécifie le status barré de la police.

setStrikethrough(strikethrough: boolean): void;

Paramètres

strikethrough

boolean

Retours

void

setUnderline(underline)

Type de soulignement appliqué à la police. Pour plus d’informations, consultez ExcelScript.ConditionalRangeFontUnderlineStyle .

setUnderline(underline: ConditionalRangeFontUnderlineStyle): void;

Paramètres

Retours

void