Partager via

ExcelScript.RangeFont interface

  • Référence
Paquet:
ExcelScript

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

Remarques

Exemples

/**
 * This script sets the font of A1 to Arial, size 16.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.
  const cellFont = cell.getFormat().getFont();
  cellFont.setName("Arial");
  cellFont.setSize(16);
}

Méthodes

getBold()

Représente l’état en gras de la police.
getColor()

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

Spécifie l’état italique de la police.
getName()

Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères.
getSize()

Taille de police
getStrikethrough()

Spécifie l’état barré de la police. Une null valeur indique que la plage entière n’a pas de paramètre barré uniforme.
getSubscript()

Spécifie l’état d’indice de la police. Retourne true si toutes les polices de la plage sont en indice. Retourne false si toutes les polices de la plage sont en exposant ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.
getSuperscript()

Spécifie l’état exposant de la police. Retourne true si toutes les polices de la plage sont en exposant. Retourne false si toutes les polices de la plage sont en indice ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.
getTintAndShade()

Spécifie un double qui éclaircit ou assombrit une couleur pour la police 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 entière n’a pas de paramètre de police tintAndShade uniforme.
getUnderline()

Type de soulignement appliqué à la police. Pour plus d’informations, consultez ExcelScript.RangeUnderlineStyle .
setBold(bold)

Représente l’état en gras de la police.
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 l’état italique de la police.
setName(name)

Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères.
setSize(size)

Taille de police
setStrikethrough(strikethrough)

Spécifie l’état barré de la police. Une null valeur indique que la plage entière n’a pas de paramètre barré uniforme.
setSubscript(subscript)

Spécifie l’état d’indice de la police. Retourne true si toutes les polices de la plage sont en indice. Retourne false si toutes les polices de la plage sont en exposant ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.
setSuperscript(superscript)

Spécifie l’état exposant de la police. Retourne true si toutes les polices de la plage sont en exposant. Retourne false si toutes les polices de la plage sont en indice ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.
setTintAndShade(tintAndShade)

Spécifie un double qui éclaircit ou assombrit une couleur pour la police 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 entière n’a pas de paramètre de police tintAndShade uniforme.
setUnderline(underline)

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

Détails de la méthode

getBold()

Représente l’état en gras de la police.

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 l’état italique de la police.

getItalic(): boolean;

Retours

boolean

getName()

Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères.

getName(): string;

Retours

string

getSize()

Taille de police

getSize(): number;

Retours

number

getStrikethrough()

Spécifie l’état barré de la police. Une null valeur indique que la plage entière n’a pas de paramètre barré uniforme.

getStrikethrough(): boolean;

Retours

boolean

getSubscript()

Spécifie l’état d’indice de la police. Retourne true si toutes les polices de la plage sont en indice. Retourne false si toutes les polices de la plage sont en exposant ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.

getSubscript(): boolean;

Retours

boolean

getSuperscript()

Spécifie l’état exposant de la police. Retourne true si toutes les polices de la plage sont en exposant. Retourne false si toutes les polices de la plage sont en indice ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.

getSuperscript(): boolean;

Retours

boolean

getTintAndShade()

Spécifie un double qui éclaircit ou assombrit une couleur pour la police 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 entière n’a pas de paramètre de police tintAndShade uniforme.

getTintAndShade(): number;

Retours

number

getUnderline()

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

getUnderline(): RangeUnderlineStyle;

Retours

ExcelScript.RangeUnderlineStyle

setBold(bold)

Représente l’état en gras de la police.

setBold(bold: boolean): void;

Paramètres

bold

boolean

Retours

void

Exemples

/**
 * This script bolds the text of cell A1.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Bold the font for that cell
  cell.getFormat().getFont().setBold(true);
}

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 l’état italique de la police.

setItalic(italic: boolean): void;

Paramètres

italic

boolean

Retours

void

setName(name)

Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères.

setName(name: string): void;

Paramètres

name

string

Retours

void

Exemples

/**
 * This script sets the font style of A1 to Arial.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.
  cell.getFormat().getFont().setName("Arial");
}

setSize(size)

Taille de police

setSize(size: number): void;

Paramètres

size

number

Retours

void

Exemples

/**
 * This script sets the font size of A1 to 16.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.clear
  cell.getFormat().getFont().setSize(16);
}

setStrikethrough(strikethrough)

Spécifie l’état barré de la police. Une null valeur indique que la plage entière n’a pas de paramètre barré uniforme.

setStrikethrough(strikethrough: boolean): void;

Paramètres

strikethrough

boolean

Retours

void

setSubscript(subscript)

Spécifie l’état d’indice de la police. Retourne true si toutes les polices de la plage sont en indice. Retourne false si toutes les polices de la plage sont en exposant ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.

setSubscript(subscript: boolean): void;

Paramètres

subscript

boolean

Retours

void

setSuperscript(superscript)

Spécifie l’état exposant de la police. Retourne true si toutes les polices de la plage sont en exposant. Retourne false si toutes les polices de la plage sont en indice ou normales (ni exposant, ni indice). Retourne null dans le cas contraire.

setSuperscript(superscript: boolean): void;

Paramètres

superscript

boolean

Retours

void

setTintAndShade(tintAndShade)

Spécifie un double qui éclaircit ou assombrit une couleur pour la police 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 entière n’a pas de paramètre de police tintAndShade uniforme.

setTintAndShade(tintAndShade: number): void;

Paramètres

tintAndShade

number

Retours

void

setUnderline(underline)

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

setUnderline(underline: RangeUnderlineStyle): void;

Paramètres

underline
ExcelScript.RangeUnderlineStyle

Retours

void