ExcelScript.RangeFont interface

Paket:

ExcelScript

Dieses Objekt stellt die Zeichenformatierung (Schriftart, Schriftgrad, Farbe usw.) für ein Objekt dar.

Hinweise

Beispiele

/**
 * 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);
}

Methoden

getBold()	Stellt den Fettdruckstatus der Schriftart dar.
getColor()	HTML-Farbcodedarstellung der Textfarbe (z. B. #FF0000 steht für Rot).
getItalic()	Gibt den Kursivstatus der Schriftart an.
getName()	Schriftartname (z. B. "Calibri"). Die Länge des Namens darf nicht größer als 31 Zeichen sein.
getSize()	Schriftgrad
getStrikethrough()	Gibt den durchgestrichenen Status der Schriftart an. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Durchstreichungseinstellung aufweist.
getSubscript()	Gibt den Tiefgestelltstatus der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs tiefgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs hoch- oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .
getSuperscript()	Gibt den hochgestellten Status der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs hochgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs tiefgestellt oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .
getTintAndShade()	Gibt ein Double an, das eine Farbe für die Bereichsschriftart aufhellt oder abdunkeln kann. Der Wert liegt zwischen -1 (dunkelster) und 1 (hellste), mit 0 für die ursprüngliche Farbe. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Schriftarteinstellung tintAndShade aufweist.
getUnderline()	Art der auf die Schriftart angewendeten Unterstreichung. Weitere Informationen finden Sie unter ExcelScript.RangeUnderlineStyle .
setBold(bold)	Stellt den Fettdruckstatus der Schriftart dar.
setColor(color)	HTML-Farbcodedarstellung der Textfarbe (z. B. #FF0000 steht für Rot).
setItalic(italic)	Gibt den Kursivstatus der Schriftart an.
setName(name)	Schriftartname (z. B. "Calibri"). Die Länge des Namens darf nicht größer als 31 Zeichen sein.
setSize(size)	Schriftgrad
setStrikethrough(strikethrough)	Gibt den durchgestrichenen Status der Schriftart an. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Durchstreichungseinstellung aufweist.
setSubscript(subscript)	Gibt den Tiefgestelltstatus der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs tiefgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs hoch- oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .
setSuperscript(superscript)	Gibt den hochgestellten Status der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs hochgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs tiefgestellt oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .
setTintAndShade(tintAndShade)	Gibt ein Double an, das eine Farbe für die Bereichsschriftart aufhellt oder abdunkeln kann. Der Wert liegt zwischen -1 (dunkelster) und 1 (hellste), mit 0 für die ursprüngliche Farbe. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Schriftarteinstellung tintAndShade aufweist.
setUnderline(underline)	Art der auf die Schriftart angewendeten Unterstreichung. Weitere Informationen finden Sie unter ExcelScript.RangeUnderlineStyle .

Details zur Methode

getBold()

Stellt den Fettdruckstatus der Schriftart dar.

getBold(): boolean;

Gibt zurück

boolean

getColor()

HTML-Farbcodedarstellung der Textfarbe (z. B. #FF0000 steht für Rot).

getColor(): string;

Gibt zurück

string

getItalic()

Gibt den Kursivstatus der Schriftart an.

getItalic(): boolean;

Gibt zurück

boolean

getName()

Schriftartname (z. B. "Calibri"). Die Länge des Namens darf nicht größer als 31 Zeichen sein.

getName(): string;

Gibt zurück

string

getSize()

Schriftgrad

getSize(): number;

Gibt zurück

number

getStrikethrough()

Gibt den durchgestrichenen Status der Schriftart an. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Durchstreichungseinstellung aufweist.

getStrikethrough(): boolean;

Gibt zurück

boolean

getSubscript()

Gibt den Tiefgestelltstatus der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs tiefgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs hoch- oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .

getSubscript(): boolean;

Gibt zurück

boolean

getSuperscript()

Gibt den hochgestellten Status der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs hochgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs tiefgestellt oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .

getSuperscript(): boolean;

Gibt zurück

boolean

getTintAndShade()

Gibt ein Double an, das eine Farbe für die Bereichsschriftart aufhellt oder abdunkeln kann. Der Wert liegt zwischen -1 (dunkelster) und 1 (hellste), mit 0 für die ursprüngliche Farbe. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Schriftarteinstellung tintAndShade aufweist.

getTintAndShade(): number;

Gibt zurück

number

getUnderline()

Art der auf die Schriftart angewendeten Unterstreichung. Weitere Informationen finden Sie unter ExcelScript.RangeUnderlineStyle .

getUnderline(): RangeUnderlineStyle;

Gibt zurück

ExcelScript.RangeUnderlineStyle

setBold(bold)

Stellt den Fettdruckstatus der Schriftart dar.

setBold(bold: boolean): void;

Parameter

bold

boolean

Gibt zurück

void

Beispiele

/**
 * 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)

HTML-Farbcodedarstellung der Textfarbe (z. B. #FF0000 steht für Rot).

setColor(color: string): void;

Parameter

color

string

Gibt zurück

void

setItalic(italic)

Gibt den Kursivstatus der Schriftart an.

setItalic(italic: boolean): void;

Parameter

italic

boolean

Gibt zurück

void

setName(name)

Schriftartname (z. B. "Calibri"). Die Länge des Namens darf nicht größer als 31 Zeichen sein.

setName(name: string): void;

Parameter

name

string

Gibt zurück

void

Beispiele

/**
 * 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)

Schriftgrad

setSize(size: number): void;

Parameter

size

number

Gibt zurück

void

Beispiele

/**
 * 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)

Gibt den durchgestrichenen Status der Schriftart an. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Durchstreichungseinstellung aufweist.

setStrikethrough(strikethrough: boolean): void;

Parameter

strikethrough

boolean

Gibt zurück

void

setSubscript(subscript)

Gibt den Tiefgestelltstatus der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs tiefgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs hoch- oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .

setSubscript(subscript: boolean): void;

Parameter

subscript

boolean

Gibt zurück

void

setSuperscript(superscript)

Gibt den hochgestellten Status der Schriftart an. Gibt zurück true , wenn alle Schriftarten des Bereichs hochgestellt sind. Gibt zurück false , wenn alle Schriftarten des Bereichs tiefgestellt oder normal sind (weder hochgestellt noch tiefgestellt). Gibt andernfalls zurück null .

setSuperscript(superscript: boolean): void;

Parameter

superscript

boolean

Gibt zurück

void

setTintAndShade(tintAndShade)

Gibt ein Double an, das eine Farbe für die Bereichsschriftart aufhellt oder abdunkeln kann. Der Wert liegt zwischen -1 (dunkelster) und 1 (hellste), mit 0 für die ursprüngliche Farbe. Ein null -Wert gibt an, dass der gesamte Bereich keine einheitliche Schriftarteinstellung tintAndShade aufweist.

setTintAndShade(tintAndShade: number): void;

Parameter

tintAndShade

number

Gibt zurück

void

setUnderline(underline)

Art der auf die Schriftart angewendeten Unterstreichung. Weitere Informationen finden Sie unter ExcelScript.RangeUnderlineStyle .

setUnderline(underline: RangeUnderlineStyle): void;

Parameter

underline

ExcelScript.RangeUnderlineStyle

Gibt zurück

void