BitmapCache.EnableClearType Property

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a value that indicates whether the bitmap is rendered with ClearType activated.

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

public bool EnableClearType { get; set; }

Property Value

Type: System.Boolean

true if ClearType is active; otherwise, false. The default is false.

Set the EnableClearType property to allow ClearType text to be rendered in the cache.

When the EnableClearType property is true, your application must render all of its ClearType text on an opaque background.

When the EnableClearType property is false, text in the cache is rendered with grayscale antialiasing.

ClearType text requires correct pixel alignment of rendered characters, so you should set the SnapsToDevicePixels property to true. If you do not set this property, the content may not blend correctly.

Use the EnableClearType property when you know the cache is rendered on pixel boundaries, so it is safe to cache ClearType text. This situation occurs commonly in text-scrolling scenarios.

.NET Framework
Available since 4.0
Return to top