ExcelScript.ShapeFont interface

Paquet:

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éthodes

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;

Retours

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;

Retours

string

getItalic()

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

getItalic(): boolean;

Retours

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;

Retours

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;

Retours

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;

Retours

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

Retours

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

Retours

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

Retours

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

Retours

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

Retours

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

Retours

void