ExcelScript.RangeFont interface
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
get |
Representa o status em negrito da fonte. |
get |
Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho). |
get |
Especifica o status itálico da fonte. |
get |
Nome da fonte (por exemplo, "Calibri"). O comprimento do nome não deve ser maior que 31 caracteres. |
get |
Font Size |
get |
Especifica o status strikethrough da fonte. Um |
get |
Especifica o status de subscrição da fonte. Retornará |
get |
Especifica o status de superscript da fonte. Retornará |
get |
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 |
get |
Tipo de sublinhado aplicado à fonte. Confira |
set |
Representa o status em negrito da fonte. |
set |
Representação de código de cor HTML da cor do texto (por exemplo, #FF0000 representa Vermelho). |
set |
Especifica o status itálico da fonte. |
set |
Nome da fonte (por exemplo, "Calibri"). O comprimento do nome não deve ser maior que 31 caracteres. |
set |
Font Size |
set |
Especifica o status strikethrough da fonte. Um |
set |
Especifica o status de subscrição da fonte. Retornará |
set |
Especifica o status de superscript da fonte. Retornará |
set |
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 |
set |
Tipo de sublinhado aplicado à fonte. Confira |
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
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de