ExcelScript.RangeFont interface
Cet objet représente les attributs de police (nom de la police, taille de police, couleur, etc.) d’un objet.
Remarques
Exemples
/**
* 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éthodes
get |
Représente l’état en gras de la police. |
get |
Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge). |
get |
Spécifie l’état italique de la police. |
get |
Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères. |
get |
Taille de police |
get |
Spécifie l’état barré de la police. Une |
get |
Spécifie l’état d’indice de la police. Retourne |
get |
Spécifie l’état exposant de la police. Retourne |
get |
Spécifie un double qui éclaircit ou assombrit une couleur pour la police de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une |
get |
Type de soulignement appliqué à la police. Pour plus d’informations, consultez |
set |
Représente l’état en gras de la police. |
set |
Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge). |
set |
Spécifie l’état italique de la police. |
set |
Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères. |
set |
Taille de police |
set |
Spécifie l’état barré de la police. Une |
set |
Spécifie l’état d’indice de la police. Retourne |
set |
Spécifie l’état exposant de la police. Retourne |
set |
Spécifie un double qui éclaircit ou assombrit une couleur pour la police de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une |
set |
Type de soulignement appliqué à la police. Pour plus d’informations, consultez |
Détails de la méthode
getBold()
Représente l’état en gras de la police.
getBold(): boolean;
Retours
boolean
getColor()
Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge).
getColor(): string;
Retours
string
getItalic()
Spécifie l’état italique de la police.
getItalic(): boolean;
Retours
boolean
getName()
Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères.
getName(): string;
Retours
string
getSize()
Taille de police
getSize(): number;
Retours
number
getStrikethrough()
Spécifie l’état barré de la police. Une null
valeur indique que la plage entière n’a pas de paramètre barré uniforme.
getStrikethrough(): boolean;
Retours
boolean
getSubscript()
Spécifie l’état d’indice de la police. Retourne true
si toutes les polices de la plage sont en indice. Retourne false
si toutes les polices de la plage sont en exposant ou normales (ni exposant, ni indice). Retourne null
dans le cas contraire.
getSubscript(): boolean;
Retours
boolean
getSuperscript()
Spécifie l’état exposant de la police. Retourne true
si toutes les polices de la plage sont en exposant. Retourne false
si toutes les polices de la plage sont en indice ou normales (ni exposant, ni indice). Retourne null
dans le cas contraire.
getSuperscript(): boolean;
Retours
boolean
getTintAndShade()
Spécifie un double qui éclaircit ou assombrit une couleur pour la police de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une null
valeur indique que la plage entière n’a pas de paramètre de police tintAndShade
uniforme.
getTintAndShade(): number;
Retours
number
getUnderline()
Type de soulignement appliqué à la police. Pour plus d’informations, consultez ExcelScript.RangeUnderlineStyle
.
getUnderline(): RangeUnderlineStyle;
Retours
setBold(bold)
Représente l’état en gras de la police.
setBold(bold: boolean): void;
Paramètres
- bold
-
boolean
Retours
void
Exemples
/**
* 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)
Représentation par code de couleur HTML de la couleur du texte (par exemple, #FF0000 représente le rouge).
setColor(color: string): void;
Paramètres
- color
-
string
Retours
void
setItalic(italic)
Spécifie l’état italique de la police.
setItalic(italic: boolean): void;
Paramètres
- italic
-
boolean
Retours
void
setName(name)
Nom de la police (par exemple, « Calibri »). La longueur du nom ne doit pas être supérieure à 31 caractères.
setName(name: string): void;
Paramètres
- name
-
string
Retours
void
Exemples
/**
* 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)
Taille de police
setSize(size: number): void;
Paramètres
- size
-
number
Retours
void
Exemples
/**
* 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)
Spécifie l’état barré de la police. Une null
valeur indique que la plage entière n’a pas de paramètre barré uniforme.
setStrikethrough(strikethrough: boolean): void;
Paramètres
- strikethrough
-
boolean
Retours
void
setSubscript(subscript)
Spécifie l’état d’indice de la police. Retourne true
si toutes les polices de la plage sont en indice. Retourne false
si toutes les polices de la plage sont en exposant ou normales (ni exposant, ni indice). Retourne null
dans le cas contraire.
setSubscript(subscript: boolean): void;
Paramètres
- subscript
-
boolean
Retours
void
setSuperscript(superscript)
Spécifie l’état exposant de la police. Retourne true
si toutes les polices de la plage sont en exposant. Retourne false
si toutes les polices de la plage sont en indice ou normales (ni exposant, ni indice). Retourne null
dans le cas contraire.
setSuperscript(superscript: boolean): void;
Paramètres
- superscript
-
boolean
Retours
void
setTintAndShade(tintAndShade)
Spécifie un double qui éclaircit ou assombrit une couleur pour la police de plage. La valeur est comprise entre -1 (la plus foncée) et 1 (la plus brillante), avec 0 pour la couleur d’origine. Une null
valeur indique que la plage entière n’a pas de paramètre de police tintAndShade
uniforme.
setTintAndShade(tintAndShade: number): void;
Paramètres
- tintAndShade
-
number
Retours
void
setUnderline(underline)
Type de soulignement appliqué à la police. Pour plus d’informations, consultez ExcelScript.RangeUnderlineStyle
.
setUnderline(underline: RangeUnderlineStyle): void;
Paramètres
- underline
- ExcelScript.RangeUnderlineStyle
Retours
void