ExcelScript.RangeFill interface

Réinitialise l’arrière-plan de la plage.

clear(): void;

Retours

Exemples

/**
 * This script removes all fill color and styles from the used range.
 */
function main(workbook: ExcelScript.Workbook)
{
  // Get the used range of the current worksheet.
  let currentSheet = workbook.getActiveWorksheet();
  let usedRange = currentSheet.getUsedRange();

  // Clear the fill from the entire range.
  usedRange.getFormat().getFill().clear();
}

Code de couleur HTML représentant la couleur de l’arrière-plan, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous forme de couleur HTML nommée (par exemple, « orange »)

getColor(): string;

Retours

Modèle d’une plage. Pour plus d’informations, consultez ExcelScript.FillPattern . LinearGradient et RectangularGradient ne sont pas pris en charge. Une null valeur indique que la plage entière n’a pas de paramètre de modèle uniforme.

getPattern(): FillPattern;

Retours

Code de couleur HTML représentant la couleur du modèle de plage, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).

getPatternColor(): string;

Retours

Spécifie un double qui éclaircit ou assombrit une couleur de motif pour le remplissage de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une null valeur indique que la plage n’a pas de paramètres uniformes patternTintAndShade .

getPatternTintAndShade(): number;

Retours

Spécifie un double qui éclaircit ou assombrit une couleur pour le remplissage de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une null valeur indique que la plage n’a pas de paramètres uniformes tintAndShade .

getTintAndShade(): number;

Retours

Code de couleur HTML représentant la couleur de l’arrière-plan, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous forme de couleur HTML nommée (par exemple, « orange »)

setColor(color: string): void;

Paramètres

Retours

Exemples

/**
 * This script sets the fill color of cell A2 to blue.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range representing cell A2 from the current worksheet.
  let cell = workbook.getActiveWorksheet().getRange("A2");

  // Set the fill color to blue.
  cell.getFormat().getFill().setColor("blue");
}

Modèle d’une plage. Pour plus d’informations, consultez ExcelScript.FillPattern . LinearGradient et RectangularGradient ne sont pas pris en charge. Une null valeur indique que la plage entière n’a pas de paramètre de modèle uniforme.

setPattern(pattern: FillPattern): void;

Paramètres

Retours

Exemples

/**
 * This script sets a black-checkered fill on the selected range.
 */
function main(workbook: ExcelScript.Workbook) {
  const selected = workbook.getSelectedRange();
  selected.getFormat().getFill().setPattern(ExcelScript.FillPattern.checker);
  selected.getFormat().getFill().setPatternColor("black");
}

Code de couleur HTML représentant la couleur du modèle de plage, sous la forme #RRGGBB (par exemple, « FFA500 ») ou sous la forme d’une couleur HTML nommée (par exemple, « orange »).

setPatternColor(patternColor: string): void;

Paramètres

Retours

Spécifie un double qui éclaircit ou assombrit une couleur de motif pour le remplissage de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une null valeur indique que la plage n’a pas de paramètres uniformes patternTintAndShade .

setPatternTintAndShade(patternTintAndShade: number): void;

Paramètres

Retours

Spécifie un double qui éclaircit ou assombrit une couleur pour le remplissage de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une null valeur indique que la plage n’a pas de paramètres uniformes tintAndShade .

setTintAndShade(tintAndShade: number): void;

Paramètres

Retours