ExcelScript.ShapeFont interface

Representa os atributos de fonte, como nome da fonte, tamanho da fonte e cor, para o objeto de TextRange uma forma.

Comentários

Usada por

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. Retorna null se inclui TextRange fragmentos de texto em negrito e sem negrito.

getColor()

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

getItalic()

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

getName()

Representa o nome da fonte (por exemplo, "Calibri"). Se o texto for um Complex Script ou um idioma do Leste Asiático, este será o nome da fonte correspondente; caso contrário, é o nome da fonte latina.

getSize()

Representa o tamanho da fonte em pontos (por exemplo, 11). Retorna null se inclui TextRange fragmentos de texto com tamanhos de fonte diferentes.

getUnderline()

Tipo de sublinhado aplicado à fonte. Retorna null se inclui TextRange fragmentos de texto com estilos de sublinhado diferentes. Consulte ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

setBold(bold)

Representa o status da fonte em negrito. Retorna null se inclui TextRange fragmentos de texto em negrito e sem negrito.

setColor(color)

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

setItalic(italic)

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

setName(name)

Representa o nome da fonte (por exemplo, "Calibri"). Se o texto for um Complex Script ou um idioma do Leste Asiático, este será o nome da fonte correspondente; caso contrário, é o nome da fonte latina.

setSize(size)

Representa o tamanho da fonte em pontos (por exemplo, 11). Retorna null se inclui TextRange fragmentos de texto com tamanhos de fonte diferentes.

setUnderline(underline)

Tipo de sublinhado aplicado à fonte. Retorna null se inclui TextRange fragmentos de texto com estilos de sublinhado diferentes. Consulte ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

Detalhes do método

getBold()

Representa o status da fonte em negrito. Retorna null se inclui TextRange fragmentos de texto em negrito e sem negrito.

getBold(): boolean;

Retornos

boolean

getColor()

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

getColor(): string;

Retornos

string

getItalic()

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

getItalic(): boolean;

Retornos

boolean

getName()

Representa o nome da fonte (por exemplo, "Calibri"). Se o texto for um Complex Script ou um idioma do Leste Asiático, este será o nome da fonte correspondente; caso contrário, é o nome da fonte latina.

getName(): string;

Retornos

string

getSize()

Representa o tamanho da fonte em pontos (por exemplo, 11). Retorna null se inclui TextRange fragmentos de texto com tamanhos de fonte diferentes.

getSize(): number;

Retornos

number

getUnderline()

Tipo de sublinhado aplicado à fonte. Retorna null se inclui TextRange fragmentos de texto com estilos de sublinhado diferentes. Consulte ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

getUnderline(): ShapeFontUnderlineStyle;

Retornos

setBold(bold)

Representa o status da fonte em negrito. Retorna null se inclui TextRange fragmentos de texto em negrito e sem negrito.

setBold(bold: boolean): void;

Parâmetros

bold

boolean

Retornos

void

setColor(color)

Representação da cor do texto no código de cores HTML (por exemplo, "#FF0000" representa vermelho). Retorna null se inclui TextRange 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. Retorna null se inclui TextRange fragmentos de texto em itálico e não itálico.

setItalic(italic: boolean): void;

Parâmetros

italic

boolean

Retornos

void

setName(name)

Representa o nome da fonte (por exemplo, "Calibri"). Se o texto for um Complex Script ou um idioma do Leste Asiático, este será o nome da fonte correspondente; caso contrário, é o nome da fonte latina.

setName(name: string): void;

Parâmetros

name

string

Retornos

void

setSize(size)

Representa o tamanho da fonte em pontos (por exemplo, 11). Retorna null se inclui TextRange fragmentos de texto com tamanhos de fonte diferentes.

setSize(size: number): void;

Parâmetros

size

number

Retornos

void

setUnderline(underline)

Tipo de sublinhado aplicado à fonte. Retorna null se inclui TextRange fragmentos de texto com estilos de sublinhado diferentes. Consulte ExcelScript.ShapeFontUnderlineStyle para obter detalhes.

setUnderline(underline: ShapeFontUnderlineStyle): void;

Parâmetros

Retornos

void