Partager via

ExcelScript.ShapeFont interface

Colis:
ExcelScript

Représente les attributs de police, tels que le nom de la police, la taille de police et la couleur, pour l’objet d’une TextRange forme.

Remarques

Exemples

/**
 * This sample sets the font of a shape to be bold. 
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first shape in the current worksheet.
  const sheet = workbook.getActiveWorksheet();
  const shape = sheet.getShapes()[0];

  // Get the text font from the shape.
  const text: ExcelScript.TextRange = shape.getTextFrame().getTextRange();
  const shapeTextFont: ExcelScript.ShapeFont = text.getFont();

  // Set the font to be bold.
  shapeTextFont.setBold(true);
}

Méthode

getBold()

Représente le format de police Gras. Retourne null si inclut des TextRange fragments de texte en gras et non gras.
getColor()

Représentation par code de couleur HTML de la couleur du texte (par exemple, « #FF0000 » représente le rouge). Retourne null si inclut des TextRange fragments de texte de couleurs différentes.
getItalic()

Représente le format de police Italique. Retourne null si inclut des TextRange fragments de texte italique et non italique.
getName()

Représente le nom de la police (par exemple, « Calibri »). Si le texte est un script complexe ou une langue d’Asie de l’Est, il s’agit du nom de police correspondant ; sinon, il s’agit du nom de la police latine.
getSize()

Représente la taille de police en points (par exemple, 11). Retourne null si inclut des TextRange fragments de texte avec des tailles de police différentes.
getUnderline()

Type de soulignement appliqué à la police. Retourne null si inclut des fragments de TextRange texte avec différents styles de soulignement. Pour plus d’informations, consultez ExcelScript.ShapeFontUnderlineStyle .
setBold(bold)

Représente le format de police Gras. Retourne null si inclut des TextRange fragments de texte en gras et non gras.
setColor(color)

Représentation par code de couleur HTML de la couleur du texte (par exemple, « #FF0000 » représente le rouge). Retourne null si inclut des TextRange fragments de texte de couleurs différentes.
setItalic(italic)

Représente le format de police Italique. Retourne null si inclut des TextRange fragments de texte italique et non italique.
setName(name)

Représente le nom de la police (par exemple, « Calibri »). Si le texte est un script complexe ou une langue d’Asie de l’Est, il s’agit du nom de police correspondant ; sinon, il s’agit du nom de la police latine.
setSize(size)

Représente la taille de police en points (par exemple, 11). Retourne null si inclut des TextRange fragments de texte avec des tailles de police différentes.
setUnderline(underline)

Type de soulignement appliqué à la police. Retourne null si inclut des fragments de TextRange texte avec différents styles de soulignement. Pour plus d’informations, consultez ExcelScript.ShapeFontUnderlineStyle .

Détails de la méthode

getBold()

Représente le format de police Gras. Retourne null si inclut des TextRange fragments de texte en gras et non gras.

getBold(): boolean;

Retourne

boolean

getColor()

Représentation par code de couleur HTML de la couleur du texte (par exemple, « #FF0000 » représente le rouge). Retourne null si inclut des TextRange fragments de texte de couleurs différentes.

getColor(): string;

Retourne

string

getItalic()

Représente le format de police Italique. Retourne null si inclut des TextRange fragments de texte italique et non italique.

getItalic(): boolean;

Retourne

boolean

getName()

Représente le nom de la police (par exemple, « Calibri »). Si le texte est un script complexe ou une langue d’Asie de l’Est, il s’agit du nom de police correspondant ; sinon, il s’agit du nom de la police latine.

getName(): string;

Retourne

string

getSize()

Représente la taille de police en points (par exemple, 11). Retourne null si inclut des TextRange fragments de texte avec des tailles de police différentes.

getSize(): number;

Retourne

number

getUnderline()

Type de soulignement appliqué à la police. Retourne null si inclut des fragments de TextRange texte avec différents styles de soulignement. Pour plus d’informations, consultez ExcelScript.ShapeFontUnderlineStyle .

getUnderline(): ShapeFontUnderlineStyle;

Retourne

ExcelScript.ShapeFontUnderlineStyle

setBold(bold)

Représente le format de police Gras. Retourne null si inclut des TextRange fragments de texte en gras et non gras.

setBold(bold: boolean): void;

Paramètres

bold

boolean

Retourne

void

setColor(color)

Représentation par code de couleur HTML de la couleur du texte (par exemple, « #FF0000 » représente le rouge). Retourne null si inclut des TextRange fragments de texte de couleurs différentes.

setColor(color: string): void;

Paramètres

color

string

Retourne

void

setItalic(italic)

Représente le format de police Italique. Retourne null si inclut des TextRange fragments de texte italique et non italique.

setItalic(italic: boolean): void;

Paramètres

italic

boolean

Retourne

void

setName(name)

Représente le nom de la police (par exemple, « Calibri »). Si le texte est un script complexe ou une langue d’Asie de l’Est, il s’agit du nom de police correspondant ; sinon, il s’agit du nom de la police latine.

setName(name: string): void;

Paramètres

name

string

Retourne

void

setSize(size)

Représente la taille de police en points (par exemple, 11). Retourne null si inclut des TextRange fragments de texte avec des tailles de police différentes.

setSize(size: number): void;

Paramètres

size

number

Retourne

void

setUnderline(underline)

Type de soulignement appliqué à la police. Retourne null si inclut des fragments de TextRange texte avec différents styles de soulignement. Pour plus d’informations, consultez ExcelScript.ShapeFontUnderlineStyle .

setUnderline(underline: ShapeFontUnderlineStyle): void;

Paramètres

underline
ExcelScript.ShapeFontUnderlineStyle

Retourne

void