Application.SetCompatibleTextRenderingDefault(Boolean) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Ustawia ustawienie domyślne dla całej aplikacji dla właściwości zdefiniowanej UseCompatibleTextRendering w niektórych kontrolkach.

public:
 static void SetCompatibleTextRenderingDefault(bool defaultValue);

public static void SetCompatibleTextRenderingDefault (bool defaultValue);

static member SetCompatibleTextRenderingDefault : bool -> unit

Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)

Parametry

defaultValue: Boolean

Wartość domyślna do użycia dla nowych kontrolek. Jeśli true, nowe kontrolki, które obsługują UseCompatibleTextRendering używanie klasy opartej Graphics na GDI+ do renderowania tekstu, jeśli false, nowe kontrolki używają klasy opartej na TextRenderer GDI.

Wyjątki

InvalidOperationException

Tę metodę można wywołać tylko przed utworzeniem pierwszego okna przez aplikację Windows Forms.

Przykłady

Ważne

Aby ustawić wartość domyślną dla UseCompatibleTextRendering programu Visual Basic 2005 lub nowszego, zobacz WindowsFormsApplicationBase.UseCompatibleTextRendering.

W przypadku aplikacji języka C# program Visual Studio automatycznie dodaje wywołanie do SetCompatibleTextRenderingDefault pliku Program.cs . Aby zmienić domyślne renderowanie tekstu, zmodyfikuj wygenerowany kod.

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

Uwagi

Niektóre kontrolki Windows Forms mogą renderować tekst przy użyciu TextRenderer klasy opartej na bibliotece grafiki GDI lub Graphics klasie opartej na bibliotece grafiki GDI+. Ta zmiana została wprowadzona w .NET Framework 2.0 z powodu problemów z wydajnością i lokalizacją interfejsu GDI+. Użyj SetCompatibleTextRenderingDefault polecenia , aby ustawić wartość domyślną UseCompatibleTextRendering właściwości dla kontrolek, które obsługują tej właściwości.

Właściwość UseCompatibleTextRendering ma na celu zapewnienie zgodności wizualnej między kontrolkami Windows Forms renderujących tekst przy użyciu klasy i aplikacji wykonujących niestandardowe renderowanie tekstu przy użyciu TextRenderer Graphics klasy . W większości przypadków, jeśli aplikacja nie jest uaktualniana z .NET Framework 1.0 lub .NET Framework 1.1, zaleca się pozostawienie UseCompatibleTextRendering ustawionej wartości domyślnej .false

Klasa oparta na TextRenderer GDI została wprowadzona w .NET Framework 2.0, aby poprawić wydajność, poprawić wygląd tekstu i poprawić obsługę międzynarodowych czcionek. We wcześniejszych wersjach .NET Framework klasa oparta na Graphics GDI+ została użyta do wykonywania całego renderowania tekstu. Funkcja GDI oblicza odstępy między znakami i zawijanie wyrazów inaczej niż GDI+. W aplikacji Windows Forms, która używa Graphics klasy do renderowania tekstu, może to spowodować, że tekst kontrolek używanych TextRenderer do wyświetlania się różni się od innego tekstu w aplikacji. Aby rozwiązać ten problem z niezgodnością, można ustawić UseCompatibleTextRendering właściwość na true. Aby ustawić UseCompatibleTextRendering wartość na true dla wszystkich obsługiwanych kontrolek w aplikacji, wywołaj SetCompatibleTextRenderingDefault metodę z argumentem true.

Nigdy nie należy wywoływać tej metody, jeśli kod Windows Forms jest hostowany w innej aplikacji, takiej jak Internet Explorer. Wywołaj tę metodę tylko w aplikacjach autonomicznych Windows Forms.

Dotyczy