PerformLayout Method (TextLayout)

In This Topic

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

Syntax

Visual Basic
C#

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

public System.bool PerformLayout( 
   System.bool recalculateGlyphsBeforeLayout
)

Parameters

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

Return Value

true if the whole text fits in the bounds of TextLayout, false if some text doesn't fit in bounds and one of the Split* methods must be executed to move the rest of the text into another TextLayout instance.

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.

Reference

TextLayout Class
TextLayout Members
RecalculateGlyphs Method