[]
type RunProperties = object;
Represents a section of formatted text.
optional backColor?: Color;
Text background color. The default is transparent. Overrides the value from base format if RunProperties.format is specified.
optional bold?: boolean;
Indicates whether the font should be bolded. Overrides the value from base format if RunProperties.format is specified.
optional charWidthFactor?: number;
The character width scale factor. Valid values are between 0.1 and 10.0. The default is 1. Overrides the value from base format if RunProperties.format is specified.
optional doubleUnderline?: boolean;
Indicates if the text is double underlined. Overrides the value from base format if RunProperties.format is specified.
optional fillBrush?: Brush | null;
A reference to the brush to fill the glyphs. This property has a priority over the foreColor. Overrides the value from base format if RunProperties.format is specified.
optional font?: Font | null;
A reference to the font to be used by this run. Overrides the value from base format if RunProperties.format is specified.
optional fontFamily?: string;
The font family name. Overrides the value from base format if RunProperties.format is specified.
optional fontFeatures?: FontFeature[] | null;
An array of Microsoft OpenType typography properties. Overrides the value from base format if RunProperties.format is specified.
optional fontSize?: number;
The logical font size, in graphic units. The default value is 12. Overrides the value from base format if RunProperties.format is specified.
optional foreColor?: Color;
Text foreground color. The default is black. Overrides the value from base format if RunProperties.format is specified.
optional format?: Format | null;
A reference to the Format to be applied to the section. Setting any of the subsequent properties creates a new format based on 'format'. The null or empty value indicates the default format.
optional glyphAdvanceFactor?: number;
The scaling factor for the glyph advance value relative to font's Average Character Width. Valid values are from 0.5 up. The default is 1. Overrides the value from base format if RunProperties.format is specified.
optional glyphAdvanceOffset?: number;
The absolute increment (delta) for the glyph advance value, in graphic units. Overrides the value from base format if RunProperties.format is specified.
optional glyphWidths?: GlyphWidths;
The preferred glyph widths (generally used in CJKV fonts). Overrides the value from base format if RunProperties.format is specified.
optional hollow?: boolean;
Indicates if the glyphs are hollow (outlined), otherwise they are solid. The strokePen property must be set in order to draw outlined glyphs. Overrides the value from base format if RunProperties.format is specified.
optional italic?: boolean;
Indicates whether the font should be italicized. Overrides the value from base format if RunProperties.format is specified.
optional language?: string;
The Neutral Culture string. Overrides the value from base format if RunProperties.format is specified.
optional lineGap?: number | null;
Specifies the explicit line gap (if not null), in graphic units. Overrides the value from base format if RunProperties.format is specified.
optional paletteIndex?: number | null;
Index of a palette used for drawing color fonts. Overrides the value from base format if RunProperties.format is specified.
optional recalcFontSizeForFallbackFonts?: boolean;
Indicates whether the size of fallback font should be coerced to the size of original font (true by default). Overrides the value from base format if RunProperties.format is specified.
optional sidewaysInVerticalText?: boolean;
Indicates if all characters should appear as rotated 90 or -90 degrees in vertical text. Overrides the value from base format if RunProperties.format is specified.
optional skipNormalization?: boolean;
Indicates whether the canonical decomposition, reordering, and composition stages should be omitted. Overrides the value from base format if RunProperties.format is specified.
optional strictCanonicalDecomposition?: boolean;
Indicates whether to apply normalization to Singleton Decompositions and Post Composition Version precomposed characters. If set to true, CJK compatibility ideographs can be changed to CJK unified ideographs during the normalization process. Overrides the value from base format if RunProperties.format is specified.
optional strikethrough?: boolean;
Indicates if the strikethrough style is applied to the text. Overrides the value from base format if RunProperties.format is specified.
optional strokePen?: Pen | null;
A reference to the pen to draw glyph outlines. Overrides the value from base format if RunProperties.format is specified.
optional subscript?: boolean;
Indicates if the glyphs should be displayed as subscript. Overrides the value from base format if RunProperties.format is specified.
optional superscript?: boolean;
Indicates if the glyphs should be displayed as superscript. Overrides the value from base format if RunProperties.format is specified.
text: string;
The text of the section.
optional textRunAsCluster?: boolean;
Indicates whether the whole text run should be considered as a single Grapheme Cluster. It allows displaying several characters side-by-side horizontally in vertical text. Overrides the value from base format if RunProperties.format is specified.
optional transformToFullWidth?: boolean;
Indicates if ASCII characters should be transformed into fullwidth characters. Overrides the value from base format if RunProperties.format is specified.
optional transverseOffset?: number;
The offset of the text in the orthogonal direction, in graphic units. The default is 0. Overrides the value from base format if RunProperties.format is specified.
optional treatHyphenMinusAsHyphen?: boolean;
Indicates whether the character 'HYPHEN-MINUS' (U+002D) is treated as the character 'HYPHEN' (U+2010) by the Unicode line breaking algorithm. Overrides the value from base format if RunProperties.format is specified.
optional underline?: boolean;
Indicates if the text is underlined. Overrides the value from base format if RunProperties.format is specified.
optional uprightInVerticalText?: boolean;
Indicates if the normally sideways characters should be drawn upright in vertical text. Overrides the value from base format if RunProperties.format is specified.
optional useHorizontalMetricsForVerticalText?: boolean;
Indicates if the horizontal ascending, descending, and line gap settings should be applied to vertical text. The special vertical metrics are used by default. Overrides the value from base format if RunProperties.format is specified.
optional useTypoMetrics?: boolean;
Indicates whether the typographical font metrics should be applied instead of Windows-specific and Apple-specific font metrics. Overrides the value from base format if RunProperties.format is specified.
optional useVerticalLineGapForSideways?: boolean;
Indicates that for sideways text in vertical flow, line gap will be set according to Font.verticalLineGap. If false (the default), line gap for lines containing sideways text is set according to Font.horizontalLineGap, which can lead to different gaps between columns that contain sideways text runs and those that do not. Overrides the value from base format if RunProperties.format is specified.