1. 程式人生 > >Application .SetCompatibleTextRenderingDefault 方法

Application .SetCompatibleTextRenderingDefault 方法

將某些控制元件上定義的 UseCompatibleTextRendering 屬性設定為應用程式範圍內的預設值。

名稱空間:System.Windows.Forms
程式集:System.Windows.Forms(在 System.Windows.Forms.dll 中) 語法 列印
public static void SetCompatibleTextRenderingDefault(
    bool defaultValue
)

引數

defaultValue
型別: System .Boolean 
用於新控制元件的預設值。如果為 true
,則支援 UseCompatibleTextRendering 的新控制元件使用基於 GDI+ 的  類進行文字呈現;如果為 false,則新控制元件使用基於 GDI 的  類。 
異常 備註

某些 Windows 窗體控制元件可以使用  類(基於 GDI 圖形庫)或  類(基於 GDI+ 圖形庫)來呈現其文字。 考慮到與 GDI+ 相關的效能和本地化問題,此更改在 .NET Framework 2.0 中進行。使用 SetCompatibleTextRenderingDefault,可為支援UseCompatibleTextRendering 屬性的控制元件設定該屬性的預設值。

UseCompatibleTextRendering 屬性旨在為 Windows 窗體控制元件(使用  類來呈現文字)與 .NET Framework 1.0 和 .NET Framework 1.1 應用程式(使用  類來執行自定義文字呈現)之間提供視覺化相容性。 在大多數情況下,如果您的應用程式不是從 .NET Framework 1.0 或 .NET Framework 1.1 升級的,建議您將 UseCompatibleTextRendering 設定保留為 false 的預設值。

基於 GDI 的  類是在 .NET Framework 2.0 中引入的,用於提高效能、改善文字外觀以及提高對國際字型的支援。 在早期版本的 .NET Framework 中,基於  類的 GDI+ 用於執行所有文字呈現。 GDI 採用與 GDI+ 不同的方式計算字元間距和自動換行。在使用  類來呈現文字的 Windows 窗體應用程式中,這可能導致使用  顯示的控制元件文字外觀與應用程式中的其他文字外觀不同。 若要解決此不相容性,可將 UseCompatibleTextRendering

 屬性設定為 true。 若要將應用程式中所有受支援控制元件的 UseCompatibleTextRendering 設定為 true,請使用 true 引數來呼叫 SetCompatibleTextRenderingDefault 方法。

如果在另一個應用程式中承載 Windows 窗體程式碼,例如 Internet Explorer,切勿呼叫該方法。僅在獨立的 Windows 窗體應用程式中呼叫該方法。

示例

在 Visual C# 2005 或更高版本中,對 SetCompatibleTextRenderingDefault 的呼叫是在 Program.cs 檔案中自動生成的。 若要更改預設的文字呈現方式,請修改生成的程式碼。

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());

}

}