SetFontFamily
Sets the font family for the current TextRange.
Syntax
expression.SetFontFamily(fontFamily);
expression - A variable that represents an ApiTextRange class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| fontFamily | Optional | string | null | The font family or families used for the current text Range. Pass null or omit it to remove the font family. |
Returns
ApiTextRange | null
Example
Set the font family for all runs within a text range.
// Useful for applying a custom typeface to a specific selection.
// Apply the "Comic Sans MS" font to the entire text range.
const presentation = Api.GetPresentation();
const slide = presentation.GetSlideByIndex(0);
slide.RemoveAllObjects();
const fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
const stroke = Api.CreateStroke(0, Api.CreateNoFill());
const shape = Api.CreateShape("rect", 300 * 36000, 130 * 36000, fill, stroke);
shape.SetPosition(608400, 1267200);
const docContent = shape.GetDocContent();
const paragraph = docContent.GetElement(0);
paragraph.AddText("This text will be displayed in Comic Sans MS using the text range API.");
slide.AddObject(shape);
const range = shape.GetTextRange();
range.SetFontFamily("Comic Sans MS");