Application.SetCompatibleTextRenderingDefault(Boolean) Yöntem

Tanım

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.

Şunlara uygulanır

Ayrıca bkz.