Text

addText(): runs, fonts, colours, bullets, alignment, hyperlinks, fit and autoFit.

0Namespaces used by the C# samples

using NetCorePpt;                  // PptxGen, Slide
using NetCorePpt.CoreInterfaces;   // option objects: TextProps* / ShapeProps / ImageProps / TableProps / HAlign / VAlign ...
using NetCorePpt.CoreEnums;        // ShapeType, ChartType, MediaType, ShadowType, BulletType, DashType, SCHEME_COLORS ...
using TableRow = System.Collections.Generic.List<NetCorePpt.CoreInterfaces.TableCell>;

Text shapes can be added to Slides.

Usage

PptxGenJS · typescript

slide.addText([{ text: "TEXT", options: { OPTIONS } }]);

NetCorePpt · C#

slide.addText(new List<TextProps> {
    new TextProps { text = "TEXT", options = new TextPropsOptions { /* OPTIONS */ } }
});

Properties

Position/Size Props ( PositionProps )

Name	Type	Default	Description	Possible Values
`x`	number	`1.0`	hor location (inches)	0-n
`x`	string		hor location (percent)	'n%'. (Ex: `{x:'50%'}` middle of the Slide)
`y`	number	`1.0`	ver location (inches)	0-n
`y`	string		ver location (percent)	'n%'. (Ex: `{y:'50%'}` middle of the Slide)
`w`	number	`1.0`	width (inches)	0-n
`w`	string		width (percent)	'n%'. (Ex: `{w:'50%'}` 50% the Slide width)
`h`	number	`1.0`	height (inches)	0-n
`h`	string		height (percent)	'n%'. (Ex: `{h:'50%'}` 50% the Slide height)

Base Properties ( TextPropsOptions )

Option	Type	Unit	Default	Description	Possible Values
`align`	string		`left`	alignment	`left` or `center` or `right`
`autoFit`	boolean		`false`	"Fit to Shape"	`true` or `false`
`baseline`	number	points		text baseline value	0-256
`bold`	boolean		`false`	bold text	`true` or `false`
`breakLine`	boolean		`false`	appends a line break	`true` or `false` (only applies when used in text options) Ex: `{text:'hi', options:{breakLine:true}}`
`bullet`	boolean		`false`	bulleted text	`true` or `false`
`bullet`	object			bullet options	object with `type`, `code` or `style`. Ex: `bullet:{type:'number'}`. Ex: `bullet:{code:'2605'}`. Ex: `{style:'alphaLcPeriod'}`
`charSpacing`	number	points		character spacing	1-256. Ex: `{ charSpacing:12 }`
`color`	string			text color	hex color code or scheme color. Ex: `{ color:'0088CC' }`
`fill`	string			fill/bkgd color	hex color code or scheme color. Ex: `{ color:'0088CC' }`
`fit`	string		`none`	text fit options	`none`, `shrink`, `resize`. Ex: `{ fit:'shrink' }`
`fontFace`	string			font face	Ex: `{ fontFace:'Arial'}`
`fontSize`	number	points		font size	1-256. Ex: `{ fontSize:12 }`
`glow`	object			text glow	object with `size`, `opacity`, `color` (opt). Ex: `glow:{size:10, opacity:0.75, color:'0088CC'}`
`highlight`	string			highlight color	hex color code or scheme color. Ex: `{ color:'0088CC' }`
`hyperlink`	string			add hyperlink	object with `url` or `slide` (`tooltip` optional). Ex: `{ hyperlink:{url:'https://github.com'} }`
`indentLevel`	number	level	`0`	bullet indent level	1-32. Ex: `{ indentLevel:1 }`
`inset`	number	inches		inset/padding	1-256. Ex: `{ inset:1.25 }`
`isTextBox`	boolean		`false`	PPT "Textbox"	`true` or `false`
`italic`	boolean		`false`	italic text	`true` or `false`
`lang`	string		`en-US`	language setting	Ex: `{ lang:'zh-TW' }` (Set this when using non-English fonts like Chinese)
`line`	object			line/border	adds a border. Ex: `line:{ width:'2', color:'A9A9A9' }`
`lineSpacing`	number	points		line spacing points	1-256. Ex: `{ lineSpacing:28 }`
`lineSpacingMultiple`	number	percent		line spacing multiple	0.0-9.99
`margin`	number	points		margin	0-99 (ProTip: use the same value from CSS `padding`)
`outline`	object			text outline options	Options: `color` & `size`. Ex: `outline:{ size:1.5, color:'FF0000' }`
`paraSpaceAfter`	number	points		paragraph spacing	Paragraph Spacing: After. Ex: `{ paraSpaceAfter:12 }`
`paraSpaceBefore`	number	points		paragraph spacing	Paragraph Spacing: Before. Ex: `{ paraSpaceBefore:12 }`
`rectRadius`	number	inches		rounding radius	rounding radius for `ROUNDED_RECTANGLE` text shapes
`rotate`	integer	degrees	`0`	text rotation degrees	0-360. Ex: `{rotate:180}`
`rtlMode`	boolean		`false`	enable Right-to-Left mode	`true` or `false`
`shadow`	object			text shadow options	see "Shadow Properties" below. Ex: `shadow:{ type:'outer' }`
`softBreakBefore`	boolean		`false`	soft (shift-enter) break	Add a soft line-break (shift+enter) before line text content
`strike`	string			text strikethrough	`dblStrike` or `sngStrike`
`subscript`	boolean		`false`	subscript text	`true` or `false`
`superscript`	boolean		`false`	superscript text	`true` or `false`
`transparency`	number		`0`	transparency	Percentage: 0-100
`underline`	TextUnderlineProps			underline color/style	TextUnderlineProps
`valign`	string			vertical alignment	`top` or `middle` or `bottom`
`vert`	string		`horz`	text direction	`eaVert` or `horz` or `mongolianVert` or `vert` or `vert270` or `wordArtVert` or `wordArtVertRtl`
`wrap`	boolean		`true`	text wrapping	`true` or `false`

Shadow Properties ( ShadowProps )

Option	Type	Unit	Default	Description	Possible Values
`type`	string		outer	shadow type	`outer` or `inner`
`angle`	number	degrees		shadow angle	0-359. Ex: `{ angle:180 }`
`blur`	number	points		blur size	1-256. Ex: `{ blur:3 }`
`color`	string			text color	hex color code or scheme color constant. Ex: `{ color:'0088CC' }`
`offset`	number	points		offset size	1-256. Ex: `{ offset:8 }`
`opacity`	number	percent		opacity	0-1. Ex: `opacity:0.75`

Examples

Text Options

PptxGenJS · typescript

var pptx = new PptxGenJS();
var slide = pptx.addSlide();

// EX: Dynamic location using percentages
slide.addText("^ (50%/50%)", { x: "50%", y: "50%" });

// EX: Basic formatting
slide.addText("Hello", { x: 0.5, y: 0.7, w: 3, color: "0000FF", fontSize: 64 });
slide.addText("World!", { x: 2.7, y: 1.0, w: 5, color: "DDDD00", fontSize: 90 });

// EX: More formatting options
slide.addText("Arial, 32pt, green, bold, underline, 0 inset", {
    x: 0.5,
    y: 5.0,
    w: "90%",
    margin: 0.5,
    fontFace: "Arial",
    fontSize: 32,
    color: "00CC00",
    bold: true,
    underline: true,
    isTextBox: true,
});

// EX: Format some text
slide.addText("Hello World!", { x: 2, y: 4, fontFace: "Arial", fontSize: 42, color: "00CC00", bold: true, italic: true, underline: true });

// EX: Multiline Text / Line Breaks - use "\n" to create line breaks inside text strings
slide.addText("Line 1\nLine 2\nLine 3", { x: 2, y: 3, color: "DDDD00", fontSize: 90 });

// EX: Format individual words or lines by passing an array of text objects with `text` and `options`
slide.addText(
    [
        { text: "word-level", options: { fontSize: 36, color: "99ABCC", align: "right", breakLine: true } },
        { text: "formatting", options: { fontSize: 48, color: "FFFF00", align: "center" } },
    ],
    { x: 0.5, y: 4.1, w: 8.5, h: 2.0, fill: { color: "F1F1F1" } }
);

// EX: Bullets
slide.addText("Regular, black circle bullet", { x: 8.0, y: 1.4, w: "30%", h: 0.5, bullet: true });
// Use line-break character to bullet multiple lines
slide.addText("Line 1\nLine 2\nLine 3", { x: 8.0, y: 2.4, w: "30%", h: 1, fill: { color: "F2F2F2" }, bullet: { type: "number" } });
// Bullets can also be applied on a per-line level
slide.addText(
    [
        { text: "I have a star bullet", options: { bullet: { code: "2605" }, color: "CC0000" } },
        { text: "I have a triangle bullet", options: { bullet: { code: "25BA" }, color: "00CD00" } },
        { text: "no bullets on this line", options: { fontSize: 12 } },
        { text: "I have a normal bullet", options: { bullet: true, color: "0000AB" } },
    ],
    { x: 8.0, y: 5.0, w: "30%", h: 1.4, color: "ABABAB", margin: 1 }
);

// EX: Paragraph Spacing
slide.addText("Paragraph spacing - before:12pt / after:24pt", {
    x: 1.5,
    y: 1.5,
    w: 6,
    h: 2,
    fill: { color: "F1F1F1" },
    paraSpaceBefore: 12,
    paraSpaceAfter: 24,
});

// EX: Hyperlink: Web
slide.addText(
    [
        {
            text: "PptxGenJS Project",
            options: { hyperlink: { url: "https://github.com/gitbrent/pptxgenjs", tooltip: "Visit Homepage" } },
        },
    ],
    { x: 1.0, y: 1.0, w: 5, h: 1 }
);
// EX: Hyperlink: Slide in Presentation
slide.addText(
    [
        {
            text: "Slide #2",
            options: { hyperlink: { slide: 2, tooltip: "Go to Summary Slide" } },
        },
    ],
    { x: 1.0, y: 2.5, w: 5, h: 1 }
);

// EX: Drop/Outer Shadow
slide.addText("Outer Shadow", {
    x: 0.5,
    y: 6.0,
    fontSize: 36,
    color: "0088CC",
    shadow: { type: "outer", color: "696969", blur: 3, offset: 10, angle: 45 },
});

// EX: Text Outline
slide.addText("Text Outline", {
    x: 0.5,
    y: 6.0,
    fontSize: 36,
    color: "0088CC",
    outline: { size: 1.5, color: "696969" },
});

// EX: Formatting can be applied at the word/line level
// Provide an array of text objects with the formatting options for that `text` string value
// Line-breaks work as well
slide.addText(
    [
        { text: "word-level\nformatting", options: { fontSize: 36, fontFace: "Courier New", color: "99ABCC", align: "right", breakLine: true } },
        { text: "...in the same textbox", options: { fontSize: 48, fontFace: "Arial", color: "FFFF00", align: "center" } },
    ],
    { x: 0.5, y: 4.1, w: 8.5, h: 2.0, margin: 0.1, fill: { color: "232323" } }
);

pptx.writeFile("Demo-Text");

NetCorePpt · C#

var pptx = new PptxGen();
var slide = pptx.addSlide();

// EX: Dynamic location using percentages
slide.addText("^ (50%/50%)", new TextPropsOptions { x = "50%", y = "50%" });

// EX: Basic formatting
slide.addText("Hello", new TextPropsOptions { x = 0.5, y = 0.7, w = 3, color = "0000FF", fontSize = 64 });
slide.addText("World!", new TextPropsOptions { x = 2.7, y = 1.0, w = 5, color = "DDDD00", fontSize = 90 });

// EX: More formatting options
slide.addText("Arial, 32pt, green, bold, underline, 0 inset", new TextPropsOptions
{
    x = 0.5,
    y = 5.0,
    w = "90%",
    margin = 0.5,
    fontFace = "Arial",
    fontSize = 32,
    color = "00CC00",
    bold = true,
    underline = true,
    isTextBox = true,
});

// EX: Format some text
slide.addText("Hello World!", new TextPropsOptions
{
    x = 2, y = 4, fontFace = "Arial", fontSize = 42, color = "00CC00",
    bold = true, italic = true, underline = true,
});

// EX: Multiline Text / Line Breaks - use "\n" to create line breaks inside text strings
slide.addText("Line 1\nLine 2\nLine 3", new TextPropsOptions { x = 2, y = 3, color = "DDDD00", fontSize = 90 });

// EX: Format individual words or lines by passing an array of text objects with `text` and `options`
slide.addText(
    new List<TextProps>
    {
        new TextProps { text = "word-level", options = new TextPropsOptions { fontSize = 36, color = "99ABCC", align = HAlign.right, breakLine = true } },
        new TextProps { text = "formatting", options = new TextPropsOptions { fontSize = 48, color = "FFFF00", align = HAlign.center } },
    },
    new TextPropsOptions { x = 0.5, y = 4.1, w = 8.5, h = 2.0, fill = new ShapeFillProps { color = "F1F1F1" } }
);

// EX: Bullets
slide.addText("Regular, black circle bullet", new TextPropsOptions { x = 8.0, y = 1.4, w = "30%", h = 0.5, bullet = true });
// Use line-break character to bullet multiple lines
slide.addText("Line 1\nLine 2\nLine 3", new TextPropsOptions
{
    x = 8.0, y = 2.4, w = "30%", h = 1,
    fill = new ShapeFillProps { color = "F2F2F2" },
    bullet = new CustomTextBullet { type = BulletType.number },
});
// Bullets can also be applied on a per-line level
slide.addText(
    new List<TextProps>
    {
        new TextProps { text = "I have a star bullet", options = new TextPropsOptions { bullet = new CustomTextBullet { characterCode = "2605" }, color = "CC0000" } },
        new TextProps { text = "I have a triangle bullet", options = new TextPropsOptions { bullet = new CustomTextBullet { characterCode = "25BA" }, color = "00CD00" } },
        new TextProps { text = "no bullets on this line", options = new TextPropsOptions { fontSize = 12 } },
        new TextProps { text = "I have a normal bullet", options = new TextPropsOptions { bullet = true, color = "0000AB" } },
    },
    new TextPropsOptions { x = 8.0, y = 5.0, w = "30%", h = 1.4, color = "ABABAB", margin = 1 }
);

// EX: Paragraph Spacing
slide.addText("Paragraph spacing - before:12pt / after:24pt", new TextPropsOptions
{
    x = 1.5,
    y = 1.5,
    w = 6,
    h = 2,
    fill = new ShapeFillProps { color = "F1F1F1" },
    paraSpaceBefore = 12,
    paraSpaceAfter = 24,
});

// EX: Hyperlink: Web
slide.addText(
    new List<TextProps>
    {
        new TextProps
        {
            text = "PptxGenJS Project",
            options = new TextPropsOptions { hyperlink = new HyperlinkProps("https://github.com/gitbrent/pptxgenjs", "Visit Homepage") },
        },
    },
    new TextPropsOptions { x = 1.0, y = 1.0, w = 5, h = 1 }
);
// EX: Hyperlink: Slide in Presentation
slide.addText(
    new List<TextProps>
    {
        new TextProps
        {
            text = "Slide #2",
            options = new TextPropsOptions { hyperlink = new HyperlinkProps(2, "Go to Summary Slide") },
        },
    },
    new TextPropsOptions { x = 1.0, y = 2.5, w = 5, h = 1 }
);

// EX: Drop/Outer Shadow
slide.addText("Outer Shadow", new TextPropsOptions
{
    x = 0.5,
    y = 6.0,
    fontSize = 36,
    color = "0088CC",
    shadow = new ShadowProps { type = ShadowType.outer, color = "696969", blur = 3, offset = 10, angle = 45 },
});

// EX: Text Outline
slide.addText("Text Outline", new TextPropsOptions
{
    x = 0.5,
    y = 6.0,
    fontSize = 36,
    color = "0088CC",
    outline = new TextOutlineOption("696969", 1.5),
});

// EX: Formatting can be applied at the word/line level
// Provide an array of text objects with the formatting options for that `text` string value
// Line-breaks work as well
slide.addText(
    new List<TextProps>
    {
        new TextProps { text = "word-level\nformatting", options = new TextPropsOptions { fontSize = 36, fontFace = "Courier New", color = "99ABCC", align = HAlign.right, breakLine = true } },
        new TextProps { text = "...in the same textbox", options = new TextPropsOptions { fontSize = 48, fontFace = "Arial", color = "FFFF00", align = HAlign.center } },
    },
    new TextPropsOptions { x = 0.5, y = 4.1, w = 8.5, h = 2.0, margin = 0.1, fill = new ShapeFillProps { color = "232323" } }
);

// PptxGenJS allows `writeFile("Demo-Text")`; NetCorePpt appends ".pptx" when missing.
await pptx.exportToFile("Demo-Text");

Line Break Options

Use the breakLine prop to force line breaks when composing text objects using an array of text objects.
Use the softBreakBefore prop to create a "soft line break" (shift-enter)

PptxGenJS · javascript

let arrTextObjs1 = [
    { text: "1st line", options: { fontSize: 24, color: "99ABCC", breakLine: true } },
    { text: "2nd line", options: { fontSize: 36, color: "FFFF00", breakLine: true } },
    { text: "3rd line", options: { fontSize: 48, color: "0088CC" } },
];
slide.addText(arrTextObjs1, { x: 0.5, y: 1, w: 8, h: 2, fill: { color: "232323" } });

let arrTextObjs2 = [
    { text: "1st line", options: { fontSize: 24, color: "99ABCC", breakLine: false } },
    { text: "2nd line", options: { fontSize: 36, color: "FFFF00", breakLine: false } },
    { text: "3rd line", options: { fontSize: 48, color: "0088CC" } },
];
slide.addText(arrTextObjs2, { x: 0.5, y: 4, w: 8, h: 2, fill: { color: "232323" } });

NetCorePpt · C#

var arrTextObjs1 = new List<TextProps>
{
    new TextProps { text = "1st line", options = new TextPropsOptions { fontSize = 24, color = "99ABCC", breakLine = true } },
    new TextProps { text = "2nd line", options = new TextPropsOptions { fontSize = 36, color = "FFFF00", breakLine = true } },
    new TextProps { text = "3rd line", options = new TextPropsOptions { fontSize = 48, color = "0088CC" } },
};
slide.addText(arrTextObjs1, new TextPropsOptions { x = 0.5, y = 1, w = 8, h = 2, fill = new ShapeFillProps { color = "232323" } });

var arrTextObjs2 = new List<TextProps>
{
    new TextProps { text = "1st line", options = new TextPropsOptions { fontSize = 24, color = "99ABCC", breakLine = false } },
    new TextProps { text = "2nd line", options = new TextPropsOptions { fontSize = 36, color = "FFFF00", breakLine = false } },
    new TextProps { text = "3rd line", options = new TextPropsOptions { fontSize = 48, color = "0088CC" } },
};
slide.addText(arrTextObjs2, new TextPropsOptions { x = 0.5, y = 4, w = 8, h = 2, fill = new ShapeFillProps { color = "232323" } });

Line Break Examples

Text Formatting

Bullet Options

Tab Stops

Samples

Runnable C# samples: see the Usage Examples section of this site.