PerformLayout Method

Determines the coordinates for all lines and glyph runs. Optionally calls RecalculateGlyphs prior to performing the layout.

Syntax

Visual Basic
C#

'Declaration
 
Public Sub PerformLayout( _
   Optional ByVal recalculateGlyphsBeforeLayout As System.Boolean _
)

public void PerformLayout( 
   System.bool recalculateGlyphsBeforeLayout
)

Parameters

recalculateGlyphsBeforeLayout: If true, RecalculateGlyphs will be called before performing the layout.

Remarks

When all text and formatting have been specified on an instance of TextLayout, RecalculateGlyphs must be called on it to convert characters to glyphs. After that, PerformLayout(false) can be called multiple times for different layout parameters (such as MaxWidth and MaxHeight to create different layouts of the same text.When only a single layout for each text is needed, the two calls can be shortened to just one PerformLayout(true) call for convenience.

If you are dealing with a large amount of text, and are going to paginate it using Split or one of the other Split* variants, you may want to use AlignmentDelayToSplit to speed up layout.

Reference

TextLayout Class
TextLayout Members
RecalculateGlyphs Method