DsPdfJS API - v9.1.0
    Preparing search index...

    Type Alias RunProperties

    Represents a section of formatted text.

    type RunProperties = {
        backColor?: Color;
        bold?: boolean;
        charWidthFactor?: number;
        doubleUnderline?: boolean;
        fillBrush?: Brush | null;
        font?: Font | null;
        fontFamily?: string;
        fontFeatures?: FontFeature[] | null;
        fontSize?: number;
        foreColor?: Color;
        format?: Format | null;
        glyphAdvanceFactor?: number;
        glyphAdvanceOffset?: number;
        glyphWidths?: GlyphWidths;
        hollow?: boolean;
        italic?: boolean;
        language?: string;
        lineGap?: number | null;
        paletteIndex?: number | null;
        recalcFontSizeForFallbackFonts?: boolean;
        sidewaysInVerticalText?: boolean;
        skipNormalization?: boolean;
        strictCanonicalDecomposition?: boolean;
        strikethrough?: boolean;
        strokePen?: Pen | null;
        subscript?: boolean;
        superscript?: boolean;
        text: string;
        textRunAsCluster?: boolean;
        transformToFullWidth?: boolean;
        transverseOffset?: number;
        treatHyphenMinusAsHyphen?: boolean;
        underline?: boolean;
        uprightInVerticalText?: boolean;
        useHorizontalMetricsForVerticalText?: boolean;
        useTypoMetrics?: boolean;
        useVerticalLineGapForSideways?: boolean;
    }
    Index

    Properties

    backColor? bold? charWidthFactor? doubleUnderline? fillBrush? font? fontFamily? fontFeatures? fontSize? foreColor? format? glyphAdvanceFactor? glyphAdvanceOffset? glyphWidths? hollow? italic? language? lineGap? paletteIndex? recalcFontSizeForFallbackFonts? sidewaysInVerticalText? skipNormalization? strictCanonicalDecomposition? strikethrough? strokePen? subscript? superscript? text textRunAsCluster? transformToFullWidth? transverseOffset? treatHyphenMinusAsHyphen? underline? uprightInVerticalText? useHorizontalMetricsForVerticalText? useTypoMetrics? useVerticalLineGapForSideways?

    Properties

    backColor?: Color

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

    bold?: boolean

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

    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?: boolean

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

    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?: 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?: string

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

    fontFeatures?: FontFeature[] | null

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

    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?: Color

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

    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?: 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?: 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?: GlyphWidths

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

    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?: boolean

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

    language?: string

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

    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?: number | null

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

    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?: 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?: 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?: 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?: boolean

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

    strokePen?: Pen | null

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

    subscript?: boolean

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

    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?: 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?: boolean

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

    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?: 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?: boolean

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

    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?: 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?: 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?: 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.

    Settings

    Member Visibility

    On This Page

    Properties