Version

SimpleTextGlyphRunMode Enumeration

Determines if and when GlyphRuns will be used instead of FormattedText in a
Syntax
'Declaration
 
Public Enum SimpleTextGlyphRunMode 
   Inherits System.Enum
public enum SimpleTextGlyphRunMode : System.Enum 
Members
MemberDescription
AlwaysAlways use GlyphRuns (default if the SimpleTextBlock.OptimizeWidthMeasurement inherits attached property returns true))
AnsiNonAlphaOnlyUse GlyphRuns only if the text being rendered doesn't have any characters outside of the 0 to 255 range or that contain any of the upper or lower case alpha characters.
AnsiOnlyUse GlyphRuns only if the text being rendered doesn't have any characters outside of the 0 to 255 range.
NeverNever use GlyphRuns (default if the SimpleTextBlock.OptimizeWidthMeasurement inherits attached property returns false)
UseGlyphRunTextEvaluatorUse a custom evaluator (that implements the interface to determine if the text should use GlyphRuns). This is the default if the SimpleTextBlock.GlyphRunTextEvaluatorProperty inherits attached property returns a non-null value).
Remarks

Note: GlyphRuns are significantly faster than FormattedText. However, they don't support ligatures or TextOptions.TextFomrmattingMode of 'Display'. The inherited attached SimpleTextBlock.GlyphRunMode" and SimpleTextBlock.GlyphRunTextEvaluator" properties are used to determine if GlyphRuns will be used..

Regardless of these settings GlyphRuns will not be used if FlowDirection is 'RightToLeft' or the text contains characters that do not map to a glyph in the current font.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also