Application.SetCompatibleTextRenderingDefault(Boolean) Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

Penting

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 TextRenderer kelas , yang didasarkan pada pustaka grafis GDI, atau Graphics kelas , yang didasarkan pada pustaka grafis GDI+. Perubahan ini dilakukan pada .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 UseCompatibleTextRendering ini dimaksudkan untuk memberikan kompatibilitas visual antara kontrol Formulir Windows yang merender teks menggunakan TextRenderer kelas dan aplikasi yang melakukan penyajian teks kustom menggunakan Graphics kelas . Dalam kebanyakan kasus, jika aplikasi Anda tidak ditingkatkan dari .NET Framework 1.0 atau .NET Framework 1.1, disarankan agar Anda membiarkan UseCompatibleTextRendering diatur ke nilai falsedefault .

Kelas berbasis TextRenderer 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 sebelumnya, kelas berbasis Graphics GDI+ digunakan untuk melakukan semua penyajian teks. GDI menghitung penspasian karakter dan pembungkusan kata secara berbeda dari GDI+. Dalam aplikasi Formulir Windows yang menggunakan Graphics kelas untuk merender teks, ini dapat menyebabkan teks untuk kontrol yang digunakan TextRenderer tampak 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

Bagikan melalui