BitmapCache.EnableClearType Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value that indicates whether the bitmap is rendered with ClearType activated.
public:
property bool EnableClearType { bool get(); void set(bool value); };
public bool EnableClearType { get; set; }
member this.EnableClearType : bool with get, set
Public Property EnableClearType As Boolean
Property Value
true
if ClearType is active; otherwise, false
. The default is false
.
Remarks
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.