Application.SetCompatibleTextRenderingDefault Method

Sets the application-wide default for the UseCompatibleTextRendering property defined on certain controls.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in

public static void SetCompatibleTextRenderingDefault (
	bool defaultValue
public static void SetCompatibleTextRenderingDefault (
	boolean defaultValue
public static function SetCompatibleTextRenderingDefault (
	defaultValue : boolean
Not applicable.



The default value to use for new controls. If true, new controls that support UseCompatibleTextRendering use GDI for text rendering; if false, new controls use GDI+.

Exception typeCondition


You can only call this method before the first window is created by your Windows Forms application.

Certain Windows Forms controls can render their text using either the GDI graphics library, or the newer GDI+ library. This change was made because of performance and localization issues with GDI+. By default, existing controls that support the UseCompatibleTextRendering property are set to true for backward compatibility, but all controls included with Windows Forms 2.0 or later have this property set to false. Use SetCompatibleTextRenderingDefault when you want to switch the default text rendering for new controls.

You should never call this method if your Windows Forms code is hosted in another application, such as Internet Explorer. Only call this method in stand-alone Windows Forms applications.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions