RunProperties

Type Alias: RunProperties

RunProperties = object

Represents a section of formatted text.

Properties

backColor?

optional backColor: Color

Text background color. The default is transparent. Overrides the value from base format if RunProperties.format is specified.

bold?

optional bold: boolean

Indicates whether the font should be bolded. Overrides the value from base format if RunProperties.format is specified.

charWidthFactor?

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.

doubleUnderline?

optional doubleUnderline: boolean

Indicates if the text is double underlined. Overrides the value from base format if RunProperties.format is specified.

fillBrush?

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.

font?

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.

fontFamily?

optional fontFamily: string

The font family name. Overrides the value from base format if RunProperties.format is specified.

fontFeatures?

optional fontFeatures: FontFeature[] | null

An array of Microsoft OpenType typography properties. Overrides the value from base format if RunProperties.format is specified.

fontSize?

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.

foreColor?

optional foreColor: Color

Text foreground color. The default is black. Overrides the value from base format if RunProperties.format is specified.

format?

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.

glyphAdvanceFactor?

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.

glyphAdvanceOffset?

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.

glyphWidths?

optional glyphWidths: GlyphWidths

The preferred glyph widths (generally used in CJKV fonts). Overrides the value from base format if RunProperties.format is specified.

hollow?

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.

italic?

optional italic: boolean

Indicates whether the font should be italicized. Overrides the value from base format if RunProperties.format is specified.

language?

optional language: string

The Neutral Culture string. Overrides the value from base format if RunProperties.format is specified.

lineGap?

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.

paletteIndex?

optional paletteIndex: number | null

Index of a palette used for drawing color fonts. Overrides the value from base format if RunProperties.format is specified.

recalcFontSizeForFallbackFonts?

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.

sidewaysInVerticalText?

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.

skipNormalization?

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.

strictCanonicalDecomposition?

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.

strikethrough?

optional strikethrough: boolean

Indicates if the strikethrough style is applied to the text. Overrides the value from base format if RunProperties.format is specified.

strokePen?

optional strokePen: Pen | null

A reference to the pen to draw glyph outlines. Overrides the value from base format if RunProperties.format is specified.

subscript?

optional subscript: boolean

Indicates if the glyphs should be displayed as subscript. Overrides the value from base format if RunProperties.format is specified.

superscript?

optional superscript: boolean

Indicates if the glyphs should be displayed as superscript. Overrides the value from base format if RunProperties.format is specified.

text

text: string

The text of the section.

textRunAsCluster?

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.

transformToFullWidth?

optional transformToFullWidth: boolean

Indicates if ASCII characters should be transformed into fullwidth characters. Overrides the value from base format if RunProperties.format is specified.

transverseOffset?

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.

treatHyphenMinusAsHyphen?

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.

underline?

optional underline: boolean

Indicates if the text is underlined. Overrides the value from base format if RunProperties.format is specified.

uprightInVerticalText?

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.

useHorizontalMetricsForVerticalText?

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.

useTypoMetrics?

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.

useVerticalLineGapForSideways?

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.