Application.SetCompatibleTextRenderingDefault(Boolean) 方法

定义

UseCompatibleTextRendering 在某些控件上定义的 属性设置应用程序范围的默认值。

public:
 static void SetCompatibleTextRenderingDefault(bool defaultValue);
public static void SetCompatibleTextRenderingDefault (bool defaultValue);
static member SetCompatibleTextRenderingDefault : bool -> unit
Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)

参数

defaultValue
Boolean

用于新控件的默认值。 如果 true为 ,则支持 UseCompatibleTextRendering 使用基于 Graphics GDI+ 的类进行文本呈现的新控件;如果 false为 ,则新控件使用基于 GDI 的 TextRenderer 类。

例外

您只能在 Windows 窗体应用程序创建第一个窗口之前调用此方法。

示例

重要

若要在 Visual Basic 2005 或更高版本中设置 的 UseCompatibleTextRendering 默认值,请参阅 WindowsFormsApplicationBase.UseCompatibleTextRendering

对于 C# 应用,Visual Studio 会自动在 Program.cs 文件中添加对 SetCompatibleTextRenderingDefault 的调用。 若要更改文本呈现默认值,请修改生成的代码。

static class Program
{
    /// <summary>
    /// The main entry point for the application.
    /// </summary>
    [STAThread]
    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.Run(new Form1());
    }
}

注解

某些Windows 窗体控件可以使用基于 GDI 图形库的 类或Graphics基于 GDI+ 图形库的 类来呈现其文本TextRenderer。 由于 GDI+ 的性能和本地化问题,.NET Framework 2.0 中进行了此更改。 使用 SetCompatibleTextRenderingDefault 为支持该 UseCompatibleTextRendering 属性的控件设置 属性的默认值。

属性UseCompatibleTextRendering旨在提供使用 类呈现文本的Windows 窗体控件与使用 TextRendererGraphics 类执行自定义文本呈现的应用之间的视觉兼容性。 在大多数情况下,如果应用程序未从 .NET Framework 1.0 或 .NET Framework 1.1 升级,建议将 UseCompatibleTextRendering 设置为默认值false

基于 TextRenderer GDI 的类是在 .NET Framework 2.0 中引入的,旨在提高性能、使文本看起来更好以及改进对国际字体的支持。 在早期版本的 .NET Framework 中,基于 Graphics GDI+ 的类用于执行所有文本呈现。 GDI 计算字符间距和换行方式与 GDI+ 不同。 在使用 类呈现文本的Windows 窗体应用程序中Graphics,这可能会导致使用 TextRenderer 的控件的文本与应用程序中的其他文本不同。 若要解决此不兼容问题,可以将 属性设置为 UseCompatibleTextRenderingtrue。 若要将 应用程序中所有受支持的控件设置为 UseCompatibleTextRenderingtrue ,请使用 参数true调用 SetCompatibleTextRenderingDefault 方法。

如果Windows 窗体代码托管在另一个应用程序(如 Internet Explorer)中,则永远不要调用此方法。 仅在独立Windows 窗体应用程序中调用此方法。

适用于

另请参阅