[]
Represents a text format.
new Format(formatProperties): Format;
Creates a new Format object with specified properties.
Text formatting attributes such as font, colors, decorations and so on.
Format
ObjectBase.constructor
new Format(baseFormat, formatProperties): Format;
Creates a new Format based on properties of an existing Format.
Format
The Format used as the base for the new Format.
The settings overriding properties of the base Format.
Format
ObjectBase.constructor
new Format(om, formatProperties): Format;
Creates a new Format object with specified properties.
An object manager that controls the lifetime of the Format object.
Text formatting attributes such as font, colors, decorations and so on.
Format
ObjectBase.constructor
get allowFontSbits(): boolean;
Gets a value indicating if the embedded bitmaps from the EBDT font table can be used.
boolean
get backColor(): Color;
Gets the text background color.
get bold(): boolean;
Gets a value indicating whether the font should be bolded.
boolean
get charWidthFactor(): number;
Gets the character width scale factor. Values are between 0.1 and 10.0.
number
get doubleUnderline(): boolean;
Gets a value indicating if the text is double underlined.
boolean
get fillBrush(): Brush;
Gets the brush to fill the glyphs.
get font(): Font;
Gets the Font used by this Format.
get fontFamily(): string;
Gets the font family name.
string
get fontFeatures(): FontFeature[];
Gets the array of assigned Microsoft OpenType typography properties.
get fontSize(): number;
Gets the logical font size, in graphic units.
number
get foreColor(): Color;
Gets the text foreground color.
get glyphAdvanceFactor(): number;
Gets the scaling factor for the glyph advance value relative to font's Average Character Width. Values are from 0.5 up.
number
get glyphAdvanceOffset(): number;
Gets the absolute increment (delta) for the glyph advance value, in graphic units.
number
get glyphWidths(): GlyphWidths;
Gets the preferred glyph widths (generally used in CJKV fonts).
get hollow(): boolean;
Gets a value indicating if the glyphs are hollow (outlined), otherwise they are solid.
boolean
get id(): number;
Gets the reference to the object.
number
get italic(): boolean;
Gets a value indicating whether the font should be italicized.
boolean
get language(): string;
Gets the Neutral Culture string, if assigned.
string
get lineGap(): number;
Gets the explicit line gap (if not null), in graphic units.
number
get om(): ObjectManager;
Gets the owner ObjectManager instance.
get paletteIndex(): number;
Gets the index of a palette used for drawing color fonts.
number
get recalcFontSizeForFallbackFonts(): boolean;
Gets a value indicating whether the size of a fallback font should be coerced to the size of original font.
boolean
get sidewaysInVerticalText(): boolean;
Gets a value indicating if all characters should appear as rotated 90 or -90 degrees in vertical text.
boolean
get skipNormalization(): boolean;
Gets a value indicating whether the canonical decomposition, reordering, and composition stages should be omitted.
boolean
get strictCanonicalDecomposition(): boolean;
Gets a value indicating whether to apply normalization to Singleton Decompositions and Post Composition Version precomposed characters.
boolean
get strikethrough(): boolean;
Gets a value indicating if the strikethrough style is applied to the text.
boolean
get strokePen(): Pen;
Gets the pen to draw glyph outlines.
get subscript(): boolean;
Gets a value indicating if the glyphs should be displayed as subscript.
boolean
get superscript(): boolean;
Gets a value indicating if the glyphs should be displayed as superscript.
boolean
get textRunAsCluster(): boolean;
Gets a value indicating whether the whole text run should be considered as a single Grapheme Cluster.
boolean
get transformToFullWidth(): boolean;
Gets a value indicating if ASCII characters should be transformed into fullwidth characters.
boolean
get transverseOffset(): number;
Gets the offset of the text in the orthogonal direction, in graphic units.
number
get treatHyphenMinusAsHyphen(): boolean;
Gets a value indicating whether the character 'HYPHEN-MINUS' (U+002D) is treated as the character 'HYPHEN' (U+2010) by the Unicode line breaking algorithm.
boolean
get underline(): boolean;
Gets a value indicating if the text is underlined.
boolean
get uprightInVerticalText(): boolean;
Gets a value indicating if the normally sideways characters should be drawn upright in vertical text.
boolean
get useHorizontalMetricsForVerticalText(): boolean;
Gets a value indicating if the horizontal ascending, descending, and line gap settings should be applied to vertical text.
boolean
get useTypoMetrics(): boolean;
Gets a value indicating whether the typographical font metrics should be applied instead of Windows-specific and Apple-specific font metrics.
boolean
get useVerticalLineGapForSideways(): boolean;
Gets a value indicating that for sideways text in vertical flow, line gap will be set according to Font.verticalLineGap. If false, 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.
boolean
free(): void;
Detaches the object from the ObjectManager and deallocates its memory, if possible.
void
rebind(omTo): void;
Rebinds the object from the current ObjectManager to the specified one.
The new ObjectManager for the object.
void