Repository navigation
ppt run
goworm edited this page Jun 26, 2026
·
50 revisions
Text run within a paragraph.
Path: /slide[N]/shape[M]/paragraph[P]/run[R]
- add - Add a run to a paragraph or shape
- set - Modify run properties
- get - Get run attributes
| Property | Accepted Values | Description |
|---|---|---|
text |
text | Run text |
font |
font name | Font family |
size |
number (pt) | Font size |
bold |
bool | Bold |
italic |
bool | Italic |
color |
hex RGB | Font color |
underline |
single, double, heavy, dotted, dash, wavy, none
|
Underline style |
spacing / charSpacing
|
points | Character spacing |
baseline |
super, sub, none, or percentage |
Baseline shift |
kern |
int (hundredths of a point) | Minimum font size at which kerning applies; 0 disables, 1 enables for all sizes |
textOutline |
width:color, or none/false
|
Text outline / glyph stroke |
textOutline.color |
hex / named / rgb(...) / scheme token |
Text outline color |
textOutline.width |
pt/cm/in/emu | Text outline stroke width |
| Key | Type | Description |
|---|---|---|
text |
string | Run text |
font |
string | Font name |
size |
number | Font size (pt) |
bold |
boolean | Bold |
italic |
boolean | Italic |
color |
string | Font color (hex) |
underline |
string | Underline style |
spacing |
number | Character spacing (points) |
baseline |
string | Baseline shift |
kern |
int | Minimum font size (hundredths of a point) at which kerning applies |
textOutline |
string | Text outline / glyph stroke (width:color) |
textOutline.color |
string | Text outline color (hex) |
textOutline.width |
string | Text outline stroke width (pt suffix) |
effective.font |
string | Inheritance-resolved font name (suppressed when font is set directly) |
effective.bold |
boolean | Inheritance-resolved bold (suppressed when bold is set directly) |
effective.color |
string | Inheritance-resolved text color, #-prefixed hex (suppressed when color is set directly) |
effective.size |
string | Inheritance-resolved font size, unit-qualified e.g. 14pt (suppressed when size is set directly) |
# Style a run
officecli set pres.pptx /slide[1]/shape[1]/paragraph[1]/run[1] --prop bold=true --prop color=FF0000 --prop underline=wavy
# Get run properties
officecli get pres.pptx /slide[1]/shape[1]/paragraph[1]/run[1]Based on OfficeCLI v1.0.64
