Partager via

ExcelScript.CellValueConditionalFormat interface

  • Référence
Paquet:
ExcelScript

Représente un format conditionnel de valeur de cellule.

Remarques

Exemples

/**
 * This script applies conditional formatting to a range.
 * That formatting is conditional upon the cell's numerical value.
 * Any value between 50 and 75 will have the cell fill color changed and the font made italic.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range to format.
  const sheet = workbook.getActiveWorksheet();
  const ratingColumn = sheet.getRange("D2:D20");

  // Add cell value conditional formatting.
  const cellValueConditionalFormatting : ExcelScript.CellValueConditionalFormat 
    = ratingColumn.addConditionalFormat(ExcelScript.ConditionalFormatType.cellValue).getCellValue();
  
  // Create the condition, in this case when the cell value is between 50 and 75.
  let rule: ExcelScript.ConditionalCellValueRule = {
    formula1: "50",
    formula2: "75",
    operator: ExcelScript.ConditionalCellValueOperator.between
  };
  cellValueConditionalFormatting.setRule(rule);

  // Set the format to apply when the condition is met.
  let format = cellValueConditionalFormatting.getFormat();
  format.getFill().setColor("yellow");
  format.getFont().setItalic(true);
}

Méthodes

getFormat()

Renvoie un objet de format, encapsulant la police, le remplissage, les bordures et d’autres propriétés des formats conditionnels.
getRule()

Spécifie l’objet de règle sur ce format conditionnel.
setRule(rule)

Spécifie l’objet de règle sur ce format conditionnel.

Détails de la méthode

getFormat()

Renvoie un objet de format, encapsulant la police, le remplissage, les bordures et d’autres propriétés des formats conditionnels.

getFormat(): ConditionalRangeFormat;

Retours

ExcelScript.ConditionalRangeFormat

getRule()

Spécifie l’objet de règle sur ce format conditionnel.

getRule(): ConditionalCellValueRule;

Retours

ExcelScript.ConditionalCellValueRule

setRule(rule)

Spécifie l’objet de règle sur ce format conditionnel.

setRule(rule: ConditionalCellValueRule): void;

Paramètres

rule
ExcelScript.ConditionalCellValueRule

Retours

void