Application.SetCompatibleTextRenderingDefault(Boolean) Metoda
Definicja
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
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 TextRendererGraphics 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.