This documentation is archived and is not being maintained.

BitmapCache.EnableClearType Property

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; }
<object EnableClearType="bool" .../>

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

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, 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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.