Application.SetCompatibleTextRenderingDefault(Boolean) Metoda

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Ustawia wartość domyślną 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 obsługujące UseCompatibleTextRendering klasę opartą Graphics na GDI+ do renderowania tekstu; jeśli falsenowe 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

Important

Aby ustawić wartość domyślną UseCompatibleTextRendering w Visual Basic 2005 lub nowszym, zobacz WindowsFormsApplicationBase.UseCompatibleTextRendering.

W przypadku aplikacji języka C# Visual Studio automatycznie dodaje wywołanie do SetCompatibleTextRenderingDefault w 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 klasy TextRenderer opartej na bibliotece grafiki GDI lub Graphics klasy opartej na bibliotece grafiki GDI+. Ta zmiana została wprowadzona w programie .NET Framework 2.0 z powodu problemów z wydajnością i lokalizacją interfejsu GDI+. Użyj SetCompatibleTextRenderingDefault , aby ustawić wartość UseCompatibleTextRendering domyślną właściwości dla kontrolek, które obsługują te 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 TextRenderer i aplikacji wykonujących niestandardowe renderowanie tekstu przy użyciu klasy Graphics. W większości przypadków zaleca się pozostawienie UseCompatibleTextRendering wartości domyślnej .false

Klasa TextRenderer oparta na interfejsie GDI została wprowadzona w .NET Framework 2.0 w celu poprawy wydajności, ulepszania wyglądu tekstu i poprawy obsługi czcionek międzynarodowych. We wcześniejszych wersjach .NET Framework użyto klasy GDI+ opartej na Graphics 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 używającej klasy Graphics do renderowania tekstu może to spowodować, że tekst kontrolek używających TextRenderer będzie wyglądać inaczej niż inny tekst w aplikacji. Aby rozwiązać ten problem z niezgodnością, możesz ustawić UseCompatibleTextRendering właściwość na true. Aby ustawić UseCompatibleTextRendering wartość na true dla wszystkich obsługiwanych kontrolek w aplikacji, wywołaj metodę SetCompatibleTextRenderingDefault 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

Zobacz też