Application.SetCompatibleTextRenderingDefault(Boolean) 方法

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

为 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 类。

例外

InvalidOperationException

您只能在 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 窗体应用程序中调用此方法。

适用于

另请参阅