BitmapCache.EnableClearType Property

Definition

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.

Applies to

See also