ExcelScript.ShapeFont interface

Pacote:

ExcelScript

Representa os atributos de fonte, como nome da fonte, tamanho da fonte e 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. Retornará null se o TextRange incluir fragmentos de texto em negrito e não negrito.
getColor()	Representação de código de cor HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Retornará null se o TextRange incluir fragmentos de texto com cores diferentes.
getItalic()	Representa o status da fonte em itálico. Retornará null se o TextRange incluir fragmentos de texto itálico e não itálico.
getName()	Representa o nome da fonte (por exemplo, "Calibri"). Se o texto for um script complexo ou uma linguagem 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). Retornará null se o TextRange incluir fragmentos de texto com diferentes tamanhos de fonte.
getUnderline()	Tipo de sublinhado aplicado à fonte. Retornará null se o TextRange incluir fragmentos de texto com diferentes estilos de sublinhado. Confira ExcelScript.ShapeFontUnderlineStyle detalhes.
setBold(bold)	Representa o status da fonte em negrito. Retornará null se o TextRange incluir fragmentos de texto em negrito e não negrito.
setColor(color)	Representação de código de cor HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Retornará null se o TextRange incluir fragmentos de texto com cores diferentes.
setItalic(italic)	Representa o status da fonte em itálico. Retornará null se o TextRange incluir fragmentos de texto itálico e não itálico.
setName(name)	Representa o nome da fonte (por exemplo, "Calibri"). Se o texto for um script complexo ou uma linguagem 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). Retornará null se o TextRange incluir fragmentos de texto com diferentes tamanhos de fonte.
setUnderline(underline)	Tipo de sublinhado aplicado à fonte. Retornará null se o TextRange incluir fragmentos de texto com diferentes estilos de sublinhado. Confira ExcelScript.ShapeFontUnderlineStyle detalhes.

Detalhes do método

getBold()

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

getBold(): boolean;

Retornos

boolean

getColor()

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

getColor(): string;

Retornos

string

getItalic()

Representa o status da fonte em itálico. Retornará null se o TextRange incluir fragmentos de texto 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 script complexo ou uma linguagem 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). Retornará null se o TextRange incluir fragmentos de texto com diferentes tamanhos de fonte.

getSize(): number;

Retornos

number

getUnderline()

Tipo de sublinhado aplicado à fonte. Retornará null se o TextRange incluir fragmentos de texto com diferentes estilos de sublinhado. Confira ExcelScript.ShapeFontUnderlineStyle detalhes.

getUnderline(): ShapeFontUnderlineStyle;

Retornos

ExcelScript.ShapeFontUnderlineStyle

setBold(bold)

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

setBold(bold: boolean): void;

Parâmetros

bold

boolean

Retornos

void

setColor(color)

Representação de código de cor HTML da cor do texto (por exemplo, "#FF0000" representa vermelho). Retornará 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. Retornará 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 da fonte (por exemplo, "Calibri"). Se o texto for um script complexo ou uma linguagem 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). Retornará null se o TextRange incluir fragmentos de texto com diferentes tamanhos de fonte.

setSize(size: number): void;

Parâmetros

size

number

Retornos

void

setUnderline(underline)

Tipo de sublinhado aplicado à fonte. Retornará null se o TextRange incluir fragmentos de texto com diferentes estilos de sublinhado. Confira ExcelScript.ShapeFontUnderlineStyle detalhes.

setUnderline(underline: ShapeFontUnderlineStyle): void;

Parâmetros

underline

ExcelScript.ShapeFontUnderlineStyle

Retornos

void