ExcelScript.ShapeFont interface

Paket:

ExcelScript

Stellt die Schriftartattribute dar, z. B. Schriftartname, Schriftgrad und Farbe, für das Objekt einer Form TextRange .

Hinweise

Beispiele

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

Methoden

getBold()	Stellt den Fett-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange fett formatierte als auch nicht fett formatierte Textfragmente enthalten sind.
getColor()	HTML-Farbcodedarstellung der Textfarbe (z. B. "#FF0000" steht für Rot). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Farben enthält.
getItalic()	Stellt den Kursiv-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange kursiv formatierte als auch nicht kursiv formatierte Textfragmente enthalten sind.
getName()	Stellt den Namen der Schriftart dar (z. B. "Calibri"). Wenn der Text eine komplexe Schrift oder eine ostasiatische Sprache ist, ist dies der entsprechende Schriftartname; andernfalls ist dies der lateinische Schriftartname.
getSize()	Stellt den Schriftgrad in Punkt dar (z. B. 11). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Schriftgraden enthält.
getUnderline()	Art der auf die Schriftart angewendeten Unterstreichung. Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Unterstreichungsstilen enthält. Weitere Informationen finden Sie unter ExcelScript.ShapeFontUnderlineStyle .
setBold(bold)	Stellt den Fett-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange fett formatierte als auch nicht fett formatierte Textfragmente enthalten sind.
setColor(color)	HTML-Farbcodedarstellung der Textfarbe (z. B. "#FF0000" steht für Rot). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Farben enthält.
setItalic(italic)	Stellt den Kursiv-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange kursiv formatierte als auch nicht kursiv formatierte Textfragmente enthalten sind.
setName(name)	Stellt den Namen der Schriftart dar (z. B. "Calibri"). Wenn der Text eine komplexe Schrift oder eine ostasiatische Sprache ist, ist dies der entsprechende Schriftartname; andernfalls ist dies der lateinische Schriftartname.
setSize(size)	Stellt den Schriftgrad in Punkt dar (z. B. 11). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Schriftgraden enthält.
setUnderline(underline)	Art der auf die Schriftart angewendeten Unterstreichung. Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Unterstreichungsstilen enthält. Weitere Informationen finden Sie unter ExcelScript.ShapeFontUnderlineStyle .

Details zur Methode

getBold()

Stellt den Fett-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange fett formatierte als auch nicht fett formatierte Textfragmente enthalten sind.

getBold(): boolean;

Gibt zurück

boolean

getColor()

HTML-Farbcodedarstellung der Textfarbe (z. B. "#FF0000" steht für Rot). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Farben enthält.

getColor(): string;

Gibt zurück

string

getItalic()

Stellt den Kursiv-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange kursiv formatierte als auch nicht kursiv formatierte Textfragmente enthalten sind.

getItalic(): boolean;

Gibt zurück

boolean

getName()

Stellt den Namen der Schriftart dar (z. B. "Calibri"). Wenn der Text eine komplexe Schrift oder eine ostasiatische Sprache ist, ist dies der entsprechende Schriftartname; andernfalls ist dies der lateinische Schriftartname.

getName(): string;

Gibt zurück

string

getSize()

Stellt den Schriftgrad in Punkt dar (z. B. 11). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Schriftgraden enthält.

getSize(): number;

Gibt zurück

number

getUnderline()

Art der auf die Schriftart angewendeten Unterstreichung. Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Unterstreichungsstilen enthält. Weitere Informationen finden Sie unter ExcelScript.ShapeFontUnderlineStyle .

getUnderline(): ShapeFontUnderlineStyle;

Gibt zurück

ExcelScript.ShapeFontUnderlineStyle

setBold(bold)

Stellt den Fett-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange fett formatierte als auch nicht fett formatierte Textfragmente enthalten sind.

setBold(bold: boolean): void;

Parameter

bold

boolean

Gibt zurück

void

setColor(color)

HTML-Farbcodedarstellung der Textfarbe (z. B. "#FF0000" steht für Rot). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Farben enthält.

setColor(color: string): void;

Parameter

color

string

Gibt zurück

void

setItalic(italic)

Stellt den Kursiv-Status der Schriftart dar. Gibt zurück null , wenn sowohl TextRange kursiv formatierte als auch nicht kursiv formatierte Textfragmente enthalten sind.

setItalic(italic: boolean): void;

Parameter

italic

boolean

Gibt zurück

void

setName(name)

Stellt den Namen der Schriftart dar (z. B. "Calibri"). Wenn der Text eine komplexe Schrift oder eine ostasiatische Sprache ist, ist dies der entsprechende Schriftartname; andernfalls ist dies der lateinische Schriftartname.

setName(name: string): void;

Parameter

name

string

Gibt zurück

void

setSize(size)

Stellt den Schriftgrad in Punkt dar (z. B. 11). Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Schriftgraden enthält.

setSize(size: number): void;

Parameter

size

number

Gibt zurück

void

setUnderline(underline)

Art der auf die Schriftart angewendeten Unterstreichung. Gibt zurück null , wenn die TextRange Textfragmente mit unterschiedlichen Unterstreichungsstilen enthält. Weitere Informationen finden Sie unter ExcelScript.ShapeFontUnderlineStyle .

setUnderline(underline: ShapeFontUnderlineStyle): void;

Parameter

underline

ExcelScript.ShapeFontUnderlineStyle

Gibt zurück

void