Application.SetCompatibleTextRenderingDefault(Boolean) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

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ını kullanır; ise falseyeni denetimler GDI tabanlı TextRenderer sınıfını kullanır.

Özel durumlar

InvalidOperationException

Bu yöntemi yalnızca ilk pencere Windows Forms uygulamanız tarafından oluşturulmadan önce çağırabilirsiniz.

Örnekler

Önemli

Visual Basic 2005 veya sonraki sürümlerinde için varsayılan değerini ayarlamak için UseCompatibleTextRendering bkz WindowsFormsApplicationBase.UseCompatibleTextRendering. .

C# uygulamaları için Visual Studio, Program.cs dosyasına otomatik olarak çağrısı SetCompatibleTextRenderingDefault 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ı TextRenderer temel alan sınıfını veya Graphics GDI+ grafik kitaplığını temel alan 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 UseCompatibleTextRendering varsayılan değerini ayarlamak için kullanınSetCompatibleTextRenderingDefault.

UseCompatibleTextRendering özelliği, sınıfını kullanarak metin işleyen Windows Forms denetimleri ile sınıfını kullanarak TextRenderer özel metin işleme Graphics gerçekleştiren uygulamalar arasında görsel uyumluluk sağlamak için tasarlanmıştır. Çoğu durumda, uygulamanız .NET Framework 1.0 veya .NET Framework 1.1'den yükseltilmiyorsa, varsayılan değerine falseayarlanmış olarak bırakmanız UseCompatibleTextRendering ö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 önceki sürümlerinde, tüm metin işlemeyi gerçekleştirmek için GDI+ tabanlı Graphics sınıfı kullanılmıştır. GDI, karakter aralığını ve sözcük kaydırmayı GDI+'dan farklı olarak hesaplar. sınıfını Graphics kullanarak metin işleyen bir Windows Forms uygulamasında bu, kullanan TextRenderer denetimlerin metninin uygulamadaki diğer metinden farklı görünmesine neden olabilir. Bu uyumsuzluğu gidermek için özelliğini olarak trueayarlayabilirsinizUseCompatibleTextRendering. 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 bu yöntemi hiçbir zaman çağırmamalısınız. Bu yöntemi yalnızca tek başına Windows Forms uygulamalarında çağır.

Şunlara uygulanır

Ayrıca bkz.