Application.SetCompatibleTextRenderingDefault(Boolean) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger standardvärdet för hela programmet för egenskapen UseCompatibleTextRendering som definierats för vissa kontroller.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)Parametrar
- defaultValue
- Boolean
Standardvärdet som ska användas för nya kontroller. Om trueanvänder nya kontroller som stöder UseCompatibleTextRendering den GDI+-baserade Graphics klassen för textåtergivning. Om falseanvänder nya kontroller den GDI-baserade TextRenderer klassen.
Undantag
Du kan bara anropa den här metoden innan det första fönstret skapas av ditt Windows Forms program.
Exempel
Important
Om du vill ange standardvärdet för UseCompatibleTextRendering i Visual Basic 2005 eller senare läser du WindowsFormsApplicationBase.UseCompatibleTextRendering.
För C#-appar lägger Visual Studio automatiskt till ett anrop till SetCompatibleTextRenderingDefault i filen Program.cs. Ändra standardvärdet för textåtergivningen genom att ändra den genererade koden.
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());
}
}
Kommentarer
Vissa Windows Forms kontroller kan återge sin text med antingen klassen TextRenderer, som baseras på GDI-grafikbiblioteket, eller klassen Graphics, som baseras på grafikbiblioteket GDI+ . Den här ändringen gjordes i .NET Framework 2.0 på grund av prestanda- och lokaliseringsproblem med GDI+. Använd SetCompatibleTextRenderingDefault för att ange standardvärdet UseCompatibleTextRendering för egenskapen för kontroller som stöder den egenskapen.
Egenskapen UseCompatibleTextRendering är avsedd att ge visuell kompatibilitet mellan Windows Forms kontroller som renderar text med klassen TextRenderer och appar som utför anpassad textrendering med klassen Graphics. I de flesta fall rekommenderar vi att du lämnar UseCompatibleTextRendering inställt på standardvärdet falseför .
Den GDI-baserade klassen TextRenderer introducerades i .NET Framework 2.0 för att förbättra prestanda, få texten att se bättre ut och förbättra stödet för internationella teckensnitt. I tidigare versioner av .NET Framework användes den GDI+-baserade klassen Graphics för att utföra all textåtergivning. GDI beräknar teckenavstånd och ordomslutning på ett annat sätt än GDI+. I ett Windows Forms program som använder klassen Graphics för att återge text kan det leda till att texten för kontroller som använder TextRenderer ser annorlunda ut än den andra texten i programmet. För att lösa den här inkompatibiliteten UseCompatibleTextRendering kan du ange egenskapen till true. Om du vill ange UseCompatibleTextRendering till för alla kontroller som stöds i programmet anropar true du metoden med argumentet SetCompatibleTextRenderingDefaulttrue .
Du bör aldrig anropa den här metoden om din Windows Forms kod finns i ett annat program, till exempel Internet Explorer. Anropa endast den här metoden i fristående Windows Forms program.
