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 la status 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 la status 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 le status 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’indice status de 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’exposant status de 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 la status 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 la status 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 le status 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’indice status de 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’exposant status de 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 la status 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 la status 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 le status 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’indice status de 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’exposant status de 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 la status 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 la status 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 le status 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’indice status de 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’exposant status de 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