Application.SetCompatibleTextRenderingDefault(Boolean) Metode

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mengatur default seluruh aplikasi untuk properti yang UseCompatibleTextRendering ditentukan pada kontrol tertentu.

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

Parameter

defaultValue
Boolean

Nilai default yang digunakan untuk kontrol baru. Jika true, kontrol baru yang mendukung UseCompatibleTextRendering menggunakan kelas berbasis Graphics GDI+ untuk penyajian teks; jika false, kontrol baru menggunakan kelas berbasis TextRenderer GDI.

Pengecualian

InvalidOperationException

Anda hanya dapat memanggil metode ini sebelum jendela pertama dibuat oleh aplikasi Formulir Windows Anda.

Contoh

Important

Untuk mengatur nilai default untuk UseCompatibleTextRendering di Visual Basic 2005 atau yang lebih baru, lihat WindowsFormsApplicationBase.UseCompatibleTextRendering.

Untuk aplikasi C#, Visual Studio secara otomatis menambahkan panggilan ke SetCompatibleTextRenderingDefault dalam file Program.cs. Untuk mengubah default penyajian teks, ubah kode yang dihasilkan.

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

Keterangan

Kontrol Formulir Windows tertentu dapat merender teksnya menggunakan kelas TextRenderer, yang didasarkan pada pustaka grafis GDI, atau kelas Graphics, yang didasarkan pada pustaka grafis GDI+. Perubahan ini dilakukan di .NET Framework 2.0 karena masalah performa dan pelokalan dengan GDI+. Gunakan SetCompatibleTextRenderingDefault untuk mengatur nilai default properti untuk kontrol yang mendukung properti tersebut UseCompatibleTextRendering .

Properti dimaksudkan untuk memberikan kompatibilitas visual antara kontrol Formulir Windows yang merender teks menggunakan kelas dan aplikasi yang melakukan penyajian teks kustom menggunakan kelas /> UseCompatibleTextRendering diatur ke nilai falsedefault .

Kelas TextRenderer berbasis GDI diperkenalkan di .NET Framework 2.0 untuk meningkatkan performa, membuat teks terlihat lebih baik, dan meningkatkan dukungan untuk font internasional. Dalam versi .NET Framework yang lebih lama, kelas Graphics berbasis GDI+ digunakan untuk melakukan semua penyajian teks. GDI menghitung penspasian karakter dan pembungkusan kata secara berbeda dari GDI+. Dalam aplikasi Formulir Windows yang menggunakan kelas Graphics untuk merender teks, ini dapat menyebabkan teks untuk kontrol yang menggunakan TextRenderer muncul berbeda dari teks lain dalam aplikasi. Untuk mengatasi ketidaksesuaian ini, Anda dapat mengatur properti ke UseCompatibleTextRenderingtrue. Untuk mengatur UseCompatibleTextRendering ke true untuk semua kontrol yang didukung dalam aplikasi, panggil SetCompatibleTextRenderingDefault metode dengan argumen .true

Anda tidak boleh memanggil metode ini jika kode Formulir Windows Anda dihosting di aplikasi lain, seperti Internet Explorer. Hanya panggil metode ini dalam aplikasi Formulir Windows yang berdiri sendiri.

Berlaku untuk

Lihat juga