ExcelScript.RangeFont interface

Pacote:

ExcelScript

Esse objeto representa os atributos de fonte de um objeto, como nome, tamanho, cor, dentre outros.

Comentários

Exemplos

/**
 * This script sets the font of A1 to Arial, size 16.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.
  const cellFont = cell.getFormat().getFont();
  cellFont.setName("Arial");
  cellFont.setSize(16);
}

Métodos

getBold()	Representa o status em negrito da fonte.
getColor()	Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).
getItalic()	Especifica o status itálico da fonte.
getName()	Nome da fonte (por exemplo, "Calibri"). O comprimento do nome não deve ser maior que 31 caracteres.
getSize()	Font Size
getStrikethrough()	Especifica o status strikethrough da fonte. Um null valor indica que todo o intervalo não tem uma configuração de strikethrough uniforme.
getSubscript()	Especifica o status de subscrição da fonte. Retornará true se todas as fontes do intervalo forem subscript. Retorna false se todas as fontes do intervalo forem superscript ou normais (nem superscript nem subscript). Retorna null caso contrário.
getSuperscript()	Especifica o status de superscript da fonte. Retornará true se todas as fontes do intervalo forem superscript. Retornará false se todas as fontes do intervalo forem subscritos ou normais (nem superscript nem subscript). Retorna null caso contrário.
getTintAndShade()	Especifica um duplo que clareia ou escure uma cor para a fonte de intervalo. O valor é entre -1 (mais escuro) e 1 (mais brilhante), com 0 para a cor original. Um null valor indica que todo o intervalo não tem uma configuração de fonte tintAndShade uniforme.
getUnderline()	Tipo de sublinhado aplicado à fonte. Confira ExcelScript.RangeUnderlineStyle detalhes.
setBold(bold)	Representa o status em negrito da fonte.
setColor(color)	Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).
setItalic(italic)	Especifica o status itálico da fonte.
setName(name)	Nome da fonte (por exemplo, "Calibri"). O comprimento do nome não deve ser maior que 31 caracteres.
setSize(size)	Font Size
setStrikethrough(strikethrough)	Especifica o status strikethrough da fonte. Um null valor indica que todo o intervalo não tem uma configuração de strikethrough uniforme.
setSubscript(subscript)	Especifica o status de subscrição da fonte. Retornará true se todas as fontes do intervalo forem subscript. Retorna false se todas as fontes do intervalo forem superscript ou normais (nem superscript nem subscript). Retorna null caso contrário.
setSuperscript(superscript)	Especifica o status de superscript da fonte. Retornará true se todas as fontes do intervalo forem superscript. Retornará false se todas as fontes do intervalo forem subscritos ou normais (nem superscript nem subscript). Retorna null caso contrário.
setTintAndShade(tintAndShade)	Especifica um duplo que clareia ou escure uma cor para a fonte de intervalo. O valor é entre -1 (mais escuro) e 1 (mais brilhante), com 0 para a cor original. Um null valor indica que todo o intervalo não tem uma configuração de fonte tintAndShade uniforme.
setUnderline(underline)	Tipo de sublinhado aplicado à fonte. Confira ExcelScript.RangeUnderlineStyle detalhes.

Detalhes do método

getBold()

Representa o status em negrito da fonte.

getBold(): boolean;

Retornos

boolean

getColor()

Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).

getColor(): string;

Retornos

string

getItalic()

Especifica o status itálico da fonte.

getItalic(): boolean;

Retornos

boolean

getName()

Nome da fonte (por exemplo, "Calibri"). O comprimento do nome não deve ser maior que 31 caracteres.

getName(): string;

Retornos

string

getSize()

Font Size

getSize(): number;

Retornos

number

getStrikethrough()

Especifica o status strikethrough da fonte. Um null valor indica que todo o intervalo não tem uma configuração de strikethrough uniforme.

getStrikethrough(): boolean;

Retornos

boolean

getSubscript()

Especifica o status de subscrição da fonte. Retornará true se todas as fontes do intervalo forem subscript. Retorna false se todas as fontes do intervalo forem superscript ou normais (nem superscript nem subscript). Retorna null caso contrário.

getSubscript(): boolean;

Retornos

boolean

getSuperscript()

Especifica o status de superscript da fonte. Retornará true se todas as fontes do intervalo forem superscript. Retornará false se todas as fontes do intervalo forem subscritos ou normais (nem superscript nem subscript). Retorna null caso contrário.

getSuperscript(): boolean;

Retornos

boolean

getTintAndShade()

Especifica um duplo que clareia ou escure uma cor para a fonte de intervalo. O valor é entre -1 (mais escuro) e 1 (mais brilhante), com 0 para a cor original. Um null valor indica que todo o intervalo não tem uma configuração de fonte tintAndShade uniforme.

getTintAndShade(): number;

Retornos

number

getUnderline()

Tipo de sublinhado aplicado à fonte. Confira ExcelScript.RangeUnderlineStyle detalhes.

getUnderline(): RangeUnderlineStyle;

Retornos

ExcelScript.RangeUnderlineStyle

setBold(bold)

Representa o status em negrito da fonte.

setBold(bold: boolean): void;

Parâmetros

bold

boolean

Retornos

void

Exemplos

/**
 * This script bolds the text of cell A1.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Bold the font for that cell
  cell.getFormat().getFont().setBold(true);
}

setColor(color)

Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho).

setColor(color: string): void;

Parâmetros

color

string

Retornos

void

setItalic(italic)

Especifica o status itálico da fonte.

setItalic(italic: boolean): void;

Parâmetros

italic

boolean

Retornos

void

setName(name)

Nome da fonte (por exemplo, "Calibri"). O comprimento do nome não deve ser maior que 31 caracteres.

setName(name: string): void;

Parâmetros

name

string

Retornos

void

Exemplos

/**
 * This script sets the font style of A1 to Arial.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.
  cell.getFormat().getFont().setName("Arial");
}

setSize(size)

Font Size

setSize(size: number): void;

Parâmetros

size

number

Retornos

void

Exemplos

/**
 * This script sets the font size of A1 to 16.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get A1 on the current worksheet.
  const cell = workbook.getActiveWorksheet().getCell(0,0);

  // Adjust the font settings for that cell.clear
  cell.getFormat().getFont().setSize(16);
}

setStrikethrough(strikethrough)

Especifica o status strikethrough da fonte. Um null valor indica que todo o intervalo não tem uma configuração de strikethrough uniforme.

setStrikethrough(strikethrough: boolean): void;

Parâmetros

strikethrough

boolean

Retornos

void

setSubscript(subscript)

Especifica o status de subscrição da fonte. Retornará true se todas as fontes do intervalo forem subscript. Retorna false se todas as fontes do intervalo forem superscript ou normais (nem superscript nem subscript). Retorna null caso contrário.

setSubscript(subscript: boolean): void;

Parâmetros

subscript

boolean

Retornos

void

setSuperscript(superscript)

Especifica o status de superscript da fonte. Retornará true se todas as fontes do intervalo forem superscript. Retornará false se todas as fontes do intervalo forem subscritos ou normais (nem superscript nem subscript). Retorna null caso contrário.

setSuperscript(superscript: boolean): void;

Parâmetros

superscript

boolean

Retornos

void

setTintAndShade(tintAndShade)

Especifica um duplo que clareia ou escure uma cor para a fonte de intervalo. O valor é entre -1 (mais escuro) e 1 (mais brilhante), com 0 para a cor original. Um null valor indica que todo o intervalo não tem uma configuração de fonte tintAndShade uniforme.

setTintAndShade(tintAndShade: number): void;

Parâmetros

tintAndShade

number

Retornos

void

setUnderline(underline)

Tipo de sublinhado aplicado à fonte. Confira ExcelScript.RangeUnderlineStyle detalhes.

setUnderline(underline: RangeUnderlineStyle): void;

Parâmetros

underline

ExcelScript.RangeUnderlineStyle

Retornos

void