Documents for PDF, .NET Edition Documentation
TextLayout Class Members
Properties  Methods 

GrapeCity.Documents.Common Assembly > GrapeCity.Documents.Text Namespace : TextLayout Class

The following tables list the members exposed by TextLayout.

Public Constructors
 NameDescription
Public ConstructorTextLayout ConstructorInitializes a new instance of the TextLayout class.

If a TextLayout is created to be used with a GrapeCity.Documents.Drawing.GcGraphics, it is recommended to use the GrapeCity.Documents.Drawing.GcGraphics.CreateTextLayout static constructor instead, as it ensures that properties such as resolution and font fallbacks are set up properly to be used with the graphics.

 
Top
Public Properties
 NameDescription
Public PropertyAddSpacingAfterLastLineGets or sets a value indicating whether the line spacing should be added after the last line of text.  
Public PropertyAlignmentDelayToSplitGets or sets a value indicating whether to delay full text alignment till when any of the Split* methods is called.

Do not use this property unless you are calling any of the Split* methods to render the text.

 
Public PropertyAnchoredObjectsGets the list of anchored objects.  
Public PropertyBidiLevelsGets the array with bidi levels of the code points.  
Public PropertyCanSkipFirstLineWithIndentationGets or sets whether the whole first line of a paragraph with indentation can be skipped.  
Public PropertyClusterMapGets the array mapping code points to glyphs.  
Public PropertyCodePointCountGets the number of code points.  
Public PropertyCodePointFlagsGets the array of CodePointFlags, one for each code point.  
Public PropertyCodePointsGets the array of UTF-32 characters (code points). Only the first CodePointCount elements should be taken into account.  
Public PropertyColumnWidthGets or sets the width of the layout box measured from the left margin (for positive values) or from the right margin (for negative values), in graphic units.  
Public PropertyContentHeightGets the height of the formatted text, in graphic units.  
Public PropertyContentHeightFitsInBoundsGets a value indicating whether the height of the formatted text fits in the specified MaxHeight.  
Public PropertyContentHeightIncludingTrailingWhitespaceGets the height of the formatted text, taking into account the trailing whitespace at the end of each line, in graphic units.  
Public PropertyContentRectangleGets the rectangle containing the formatted text, in graphic units.  
Public PropertyContentWidthGets the width of the formatted text, in graphic units.  
Public PropertyContentWidthFitsInBoundsGets a value indicating whether the width of the formatted text fits in the specified MaxWidth.  
Public PropertyContentWidthIncludingTrailingWhitespaceGets the width of the formatted text, taking into account the trailing whitespace at the end of each line, in graphic units.  
Public PropertyContentWithWhitespaceBoundsGet the rectangle of the formatted text, taking into account the trailing whitespace at the end of each line.  
Public PropertyContentXGets the X coordinate of the rectangle containing the formatted text, in graphic units.  
Public PropertyContentYGets the Y coordinate of the rectangle containing the formatted text, in graphic units.  
Public PropertyDefaultFormatGets the default text format for the current text layout.  
Public PropertyDefaultTabStopsGets or sets the spacing between the default tab stops, in graphic units.  
Public PropertyDelimiterCharCodeGets or sets a UTF-32 character code used as a delimiter that signals the beginning of the portion of text to be preserved (for text trimming).  
Public PropertyDelimiterCharCountGets or sets the delimiter count, counting from the end of the text, to preserve text from (for text trimming).  
Public PropertyEllipsisCharCodeGets or sets a UTF-32 code of the omission sign (ellipsis character) for text trimming.

Setting this property to 0 prevents the ellipsis character from showing.

 
Public PropertyFirstLineIndentGets or sets the indent of the first line after paragraph separator, in graphic units.  
Public PropertyFirstLineIsStartOfParagraphGets or sets a value indicating whether the first line of text is the start of paragraph.  
Public PropertyFlowDirectionGets or sets the flow direction (how lines of text are placed relative to one another).  
Public PropertyFontCollectionGets or sets the custom font collection used for searching fonts and font fallbacks.  
Public PropertyFontFallbackScopeGets or sets a value specifying the scope for searching fallback fonts with the glyphs missing in the font defined in TextFormat.  
Public PropertyFontScaleFactorThe uniform scale factor for all fonts used in the current text layout.

Valid values are from 0.001 to 1000. The default is 1.

 
Public PropertyFormatsGets the array of TextFormat objects, one for each code point.  
Public PropertyGeneralCategoriesGets the array with general classification of the code points.  
Public PropertyGlyphCountGets the number of resulting glyphs.  
Public PropertyGlyphLinkedListGets the linked list with each glyph info.  
Public PropertyGlyphRunMapGets the array mapping code points to glyph runs.  
Public PropertyInlineObjectsGets the list of inline objects.  
Public PropertyInlinesGets the list of inline elements derived from Inline, such as TextRun and LineBreak.  
Public PropertyJustifiedSpaceExtensionGets or sets the maximum white space extension factor before applying extension to other characters when text is justified.

Valid values are from 0 to 10000. The default is 2.5.

 
Public PropertyJustifiedSpaceShrinkingGets or sets the white space shrinking factor when text is justified.

Valid values are from 0.0 to 1.0. The default is 0.2.

 
Public PropertyJustifiedTextExtensionGets or sets the maximum text extension factor when text is justified.

Valid values are from 0 to 10000. The default is 0.3.

 
Public PropertyLastLineIsEndOfParagraphGets or sets a value indicating whether the last line of text is the end of paragraph.  
Public PropertyLayoutPerformedGets a value indicating if PerformLayout method was executed at least once.  
Public PropertyLineGapBeforeFirstLineGets or sets a value indicating whether the typographic line gap should be added before the first line of text.  
Public PropertyLinesGets the list of text lines after executing the PerformLayout method.  
Public PropertyLineSpacingScaleFactorGets or sets the scaling factor to be applied to the computed line height.

Valid values are from 0 to 1000. The default is 1.

 
Public PropertyMarginAllGets or sets all margings of the layout box, in graphic units.

Returns null if the margins have different values.

 
Public PropertyMarginBottomGets or sets the bottom margin of the layout box, in graphic units.  
Public PropertyMarginLeftGets or sets the left margin of the layout box, in graphic units.  
Public PropertyMarginRightGets or sets the right margin of the layout box, in graphic units.  
Public PropertyMarginTopGets or sets the top margin of the layout box, in graphic units.  
Public PropertyMaxHeightGets or sets the height of the layout box, in graphic units.  
Public PropertyMaxWidthGets or sets the width of the layout box, in graphic units.  
Public PropertyMinimalLineSpacingGets or sets the explicit minimal distance between lines, in graphic units.  
Public PropertyObjectRectsGets or sets the list of areas occupied by embedded objects.  
Public PropertyParagraphAlignmentGets or sets the alignment of paragraphs along the flow direction axis.  
Public PropertyParagraphSpacingGets or sets the additional spacing between paragraphs, in graphic units.  
Public PropertyResolutionGets or sets the resolution (graphic units per inch) used by the current text layout.  
Public PropertyRestrictedFontLookupGets or sets a value indicating whether the fonts should be searched in the custom collection only, if any specified.  
Public PropertyRightToLeftGets or sets the base direction for horizontal and sideways text.  
Public PropertyRotateSidewaysCounterclockwiseGets or sets a value indicating whether sideways text should be rotated counterclockwise.  
Public PropertyRowHeightGets or sets the height of the layout box measured from the top margin (for positive values) or from the bottom margin (for negative values), in graphic units.  
Public PropertyScriptCodesGets the array of ScriptCode's, one for each code point.  
Public PropertyScriptTagsGets the array of ScriptTag's, one for each code point.  
Public PropertySplitCodePointIndexGets the first code point index of the current split rest, if this TextLayout contains the rest lines after calling the Split or SplitAndBalance methods.  
Public PropertySuppressShapingGets or sets a value indicating if shaping and positioning of graphemes should be skipped for the sake of speed.  
Public PropertyTabStopsGets or sets the list of tab stops.  
Public PropertyTextAlignmentGets or sets the alignment of text along the reading direction axis.  
Public PropertyTrimmingGranularityGets or sets the text granularity used to trim text overflowing the layout box.  
Public PropertyUniformLineSpacingGets or sets the explicit distance between lines, in graphic units.  
Public PropertyUseEmbeddableFontsGets or sets a value indicating if the linked and fallback fonts have to be embeddable.  
Public PropertyUseOldScriptTagsIndicates whether the following scripts should use their old tags: Bengali, Devanagari, Gujarati, Gurmukhi, Kannada, Malayalam, Myanmar, Odia, Tamil, Telugu.  
Public PropertyVerticalDirectionGets a value indicating whether the FlowDirection was vertical when RecalculateGlyphs was last called.  
Public PropertyWrapModeGets or sets a value specifying how text lines are broken to avoid text overflowing the layout box.  
Top
Public Methods
 NameDescription
Public MethodAppendOverloaded. Adds a text run with default formatting to the end of the Inlines collection.  
Public MethodAppendAnchoredObjectAdds an anchored object with specified dimensions to the end of the Inlines collection.  
Public MethodAppendInlineObjectOverloaded. Adds an inline object with specified dimensions to the end of the Inlines collection.  
Public MethodAppendLineOverloaded. Adds a line break element to the end of the Inlines collection.  
Public MethodAppendParagraphBreakOverloaded. Adds the special character (0x2029) that causes a paragraph break but prevents a page break between paragraphs (GrapeCity specifics).  
Public MethodAppendSoftBreakOverloaded. Adds a line separator character (0x2028) that causes a line break without ending the paragraph.  
Public MethodClearClears the current text layout, removing all text and formatting associated with individual text runs.  
Public MethodGetInlineObjectAtGets the InlineObject at the specified code point index.  
Public MethodGetTextRectsReturns the list of TextRect objects for the specified range of code points.  
Public MethodMapCharRangeToCodePointsMaps a character range to the corresponding code point range.  
Public MethodMapCodePointsToCharRangeMaps a code point range to the corresponding character range.  
Public MethodPerformLayoutDetermines the coordinates for all lines and glyph runs. Optionally calls RecalculateGlyphs prior to performing the layout.  
Public MethodRecalculateGlyphsConverts characters in the current TextLayout to glyphs, and performs text shaping.

In order to layout the text (e.g. when rendering it on a graphics), a call to this method must precede the call(s) to PerformLayout, or alternatively the PerformLayout method should be called with true as the parameter.

 
Public MethodSplitFits all or the first portion of the current text layout into the current layout bounds. If the whole text did not fit into the bounds, the rest is moved into a new TextLayout instance specified by the output parameter rest.  
Public MethodSplitAndBalanceFits all or the first portion of the current text layout into one or more layout areas (such as page columns). If the whole text did not fit into the provided areas, the rest is moved into a new TextLayout instance specified by the output parameter rest.

If the whole text fits in the specified areas (i.e. rest is empty), the content is equally distributed between all areas, which in the case of page columns results in columns of equal height (balanced).

 
Public MethodSplitAndBalanceRefFits all or the first portion of the current text layout into one or more layout areas (such as page columns). If the whole text did not fit into the provided areas, the rest is moved into a new TextLayout instance specified by the output parameter rest.

If the whole text fits in the specified areas (i.e. rest is empty), the content is equally distributed between all areas, which in the case of page columns results in columns of equal height (balanced).

For details on why providing a reference to an existing TextLayout may be beneficial, see the remarks on the SplitRef method.  
Public MethodSplitRefFits all or the first portion of the current text layout into the current layout bounds. If the whole text did not fit into the bounds, the rest is moved into the TextLayout instance specified by the reference parameter rest. If it is null, a new TextLayout instance is created.  
Top
See Also

Reference

TextLayout Class
GrapeCity.Documents.Text Namespace

 

 

Copyright © GrapeCity, Inc. All rights reserved.

Product Support Forum | Print this page