Compartilhar via


ExcelScript.ShapeFont interface

Representa os atributos do tipo de letra, como o nome do tipo de letra, o tamanho do tipo de letra e a cor, para o objeto de TextRange uma forma.

Comentários

Exemplos

/**
 * 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étodos

getBold()

Representa o status da fonte em negrito. Devolve null se o TextRange incluir fragmentos de texto a negrito e não negrito.

getColor()

Representação do código de cores HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Devolve null se o TextRange incluir fragmentos de texto com cores diferentes.

getItalic()

Representa o status da fonte em itálico. Devolve null se o TextRange incluir fragmentos de texto itálico e não itálico.

getName()

Representa o nome do tipo de letra (por exemplo, "Calibri"). Se o texto for um Script Complexo ou um idioma asiático, este é o nome do tipo de letra correspondente; caso contrário, é o nome do tipo de letra latino.

getSize()

Representa o tamanho do tipo de letra em pontos (por exemplo, 11). Devolve null se incluir TextRange fragmentos de texto com tamanhos de tipo de letra diferentes.

getUnderline()

Tipo de sublinhado aplicado à fonte. Devolve null se incluir TextRange fragmentos de texto com estilos de sublinhado diferentes. Veja ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

setBold(bold)

Representa o status da fonte em negrito. Devolve null se o TextRange incluir fragmentos de texto a negrito e não negrito.

setColor(color)

Representação do código de cores HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Devolve null se o TextRange incluir fragmentos de texto com cores diferentes.

setItalic(italic)

Representa o status da fonte em itálico. Devolve null se o TextRange incluir fragmentos de texto itálico e não itálico.

setName(name)

Representa o nome do tipo de letra (por exemplo, "Calibri"). Se o texto for um Script Complexo ou um idioma asiático, este é o nome do tipo de letra correspondente; caso contrário, é o nome do tipo de letra latino.

setSize(size)

Representa o tamanho do tipo de letra em pontos (por exemplo, 11). Devolve null se incluir TextRange fragmentos de texto com tamanhos de tipo de letra diferentes.

setUnderline(underline)

Tipo de sublinhado aplicado à fonte. Devolve null se incluir TextRange fragmentos de texto com estilos de sublinhado diferentes. Veja ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

Detalhes do método

getBold()

Representa o status da fonte em negrito. Devolve null se o TextRange incluir fragmentos de texto a negrito e não negrito.

getBold(): boolean;

Retornos

boolean

getColor()

Representação do código de cores HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Devolve null se o TextRange incluir fragmentos de texto com cores diferentes.

getColor(): string;

Retornos

string

getItalic()

Representa o status da fonte em itálico. Devolve null se o TextRange incluir fragmentos de texto itálico e não itálico.

getItalic(): boolean;

Retornos

boolean

getName()

Representa o nome do tipo de letra (por exemplo, "Calibri"). Se o texto for um Script Complexo ou um idioma asiático, este é o nome do tipo de letra correspondente; caso contrário, é o nome do tipo de letra latino.

getName(): string;

Retornos

string

getSize()

Representa o tamanho do tipo de letra em pontos (por exemplo, 11). Devolve null se incluir TextRange fragmentos de texto com tamanhos de tipo de letra diferentes.

getSize(): number;

Retornos

number

getUnderline()

Tipo de sublinhado aplicado à fonte. Devolve null se incluir TextRange fragmentos de texto com estilos de sublinhado diferentes. Veja ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

getUnderline(): ShapeFontUnderlineStyle;

Retornos

setBold(bold)

Representa o status da fonte em negrito. Devolve null se o TextRange incluir fragmentos de texto a negrito e não negrito.

setBold(bold: boolean): void;

Parâmetros

bold

boolean

Retornos

void

setColor(color)

Representação do código de cores HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Devolve null se o TextRange incluir fragmentos de texto com cores diferentes.

setColor(color: string): void;

Parâmetros

color

string

Retornos

void

setItalic(italic)

Representa o status da fonte em itálico. Devolve null se o TextRange incluir fragmentos de texto itálico e não itálico.

setItalic(italic: boolean): void;

Parâmetros

italic

boolean

Retornos

void

setName(name)

Representa o nome do tipo de letra (por exemplo, "Calibri"). Se o texto for um Script Complexo ou um idioma asiático, este é o nome do tipo de letra correspondente; caso contrário, é o nome do tipo de letra latino.

setName(name: string): void;

Parâmetros

name

string

Retornos

void

setSize(size)

Representa o tamanho do tipo de letra em pontos (por exemplo, 11). Devolve null se incluir TextRange fragmentos de texto com tamanhos de tipo de letra diferentes.

setSize(size: number): void;

Parâmetros

size

number

Retornos

void

setUnderline(underline)

Tipo de sublinhado aplicado à fonte. Devolve null se incluir TextRange fragmentos de texto com estilos de sublinhado diferentes. Veja ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

setUnderline(underline: ShapeFontUnderlineStyle): void;

Parâmetros

Retornos

void