Application.SetCompatibleTextRenderingDefault(Boolean) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirli denetimlerde tanımlanan özellik için UseCompatibleTextRendering uygulama genelinde varsayılanı ayarlar.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);
public static void SetCompatibleTextRenderingDefault(bool defaultValue);
static member SetCompatibleTextRenderingDefault : bool -> unit
Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)
Parametreler
- defaultValue
- Boolean
Yeni denetimler için kullanılacak varsayılan değer. ise true, destekleyen UseCompatibleTextRendering yeni denetimler metin işleme için GDI+ tabanlı Graphics sınıfı kullanır; ise false, yeni denetimler GDI tabanlı TextRenderer sınıfı kullanır.
Özel durumlar
Bu yöntemi yalnızca ilk pencere Windows Forms uygulamanız tarafından oluşturulmadan önce çağırabilirsiniz.
Örnekler
Important
Visual Basic 2005 veya sonraki sürümlerde UseCompatibleTextRendering için varsayılan değeri ayarlamak için bkz. WindowsFormsApplicationBase.UseCompatibleTextRendering.
C# uygulamaları için Visual Studio SetCompatibleTextRenderingDefault dosyasındaki otomatik olarak bir çağrı ekler. Metin işleme varsayılanını değiştirmek için oluşturulan kodu değiştirin.
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());
}
}
Açıklamalar
Bazı Windows Forms denetimleri, GDI grafik kitaplığını temel alan TextRenderer sınıfını veya GDI+ grafik kitaplığını temel alan Graphics sınıfını kullanarak metinlerini işleyebilir. Bu değişiklik, GDI+ ile ilgili performans ve yerelleştirme sorunları nedeniyle .NET Framework 2.0'da yapılmıştır. Bu özelliği destekleyen denetimler için özelliğin SetCompatibleTextRenderingDefault varsayılan değerini ayarlamak için kullanınUseCompatibleTextRendering.
UseCompatibleTextRendering özelliği, TextRenderer sınıfını kullanarak metin işleyen Windows Forms denetimleri ile Graphics sınıfını kullanarak özel metin işleme gerçekleştiren uygulamalar arasında görsel uyumluluk sağlamaya yöneliktir. Çoğu durumda, varsayılan değerine UseCompatibleTextRenderingayarlanmış olarak bırakmanız false önerilir.
GDI tabanlı TextRenderer sınıfı, performansı geliştirmek, metnin daha iyi görünmesini sağlamak ve uluslararası yazı tipleri desteğini geliştirmek için .NET Framework 2.0'da tanıtıldı. .NET Framework'ün önceki sürümlerinde, tüm metin işlemeyi gerçekleştirmek için GDI+ tabanlı Graphics sınıfı kullanılmıştı. GDI, karakter aralığını ve sözcük kaydırmayı GDI+'dan farklı şekilde hesaplar. Metin işlemek için Graphics sınıfını kullanan bir Windows Forms uygulamasında bu, TextRenderer kullanan denetimlerin metninin uygulamadaki diğer metinden farklı görünmesine neden olabilir. Bu uyumsuzluğu gidermek için özelliğini olarak UseCompatibleTextRenderingayarlayabilirsiniztrue. Uygulamada desteklenen tüm denetimler için olarak ayarlamak UseCompatibleTextRenderingtrue için yöntemini bağımsız değişkeniyle çağırın SetCompatibleTextRenderingDefaulttrue.
Windows Forms kodunuz Internet Explorer gibi başka bir uygulamada barındırılıyorsa hiçbir zaman bu yöntemi çağırmamalısınız. Bu yöntemi yalnızca tek başına Windows Forms uygulamalarda çağır.