TextOptions.TextHintingMode

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a value that influences the rendering behavior for a text element. This setting is a performance optimization that is useful if you animate any properties of text elements.

<object TextOptions.TextHintingMode="Animated"  .../>
value = object["TextOptions.TextHintingMode"]
object["TextOptions.TextHintingMode"] = value

Property Value

Type: TextHintingMode enumeration

Declares how rendering should process the text elements.

This property is read/write.

Managed Equivalent

TextOptions.TextHintingMode

Remarks

This property takes one of two possible values: Animated or Fixed.

Animated optimizes for animation by using a more efficient, but less visually precise, smoothing algorithm. Text is still readable and the loss of precision is not that severe.

Fixed uses an algorithm that is optimized for visually precise text smoothing, but can lead to performance issues that may have visual artifacts. For example, when animations are applied to properties of a text element, in particular FontSize, you might see jitters. When transforms, positioning, or projections are applied to text elements, you might see performance issues. Fixed is the default.

You can apply this property to a layout container and the setting will apply to any text element within that container. However, in general, you should apply this property directly to a text element, such as a TextBlock, TextBox, or Glyphs, where the animations applied will only affect the text.

Applies To

Border (Silverlight 2)

Canvas

Ellipse

Glyphs

Image

InkPresenter

Line

MediaElement

PasswordBox (Silverlight 2)

Path

Polygon

Polyline

Rectangle

StackPanel (Silverlight 2)

TextBlock

TextBox (Silverlight 2)

Version Information

Silverlight 3