Application.SetCompatibleTextRenderingDefault(Boolean) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee stelt u de toepassingsbrede standaardwaarde in voor de UseCompatibleTextRendering eigenschap die is gedefinieerd voor bepaalde besturingselementen.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)Parameters
- defaultValue
- Boolean
De standaardwaarde die moet worden gebruikt voor nieuwe besturingselementen. Als truenieuwe besturingselementen die ondersteuning bieden UseCompatibleTextRendering voor het gebruik van de GDI+- Graphics klasse voor tekstweergave; als falsevoor nieuwe besturingselementen de GDI-klasse wordt gebruikt TextRenderer .
Uitzonderingen
U kunt deze methode alleen aanroepen voordat het eerste venster wordt gemaakt door uw Windows Forms toepassing.
Voorbeelden
Important
Zie UseCompatibleTextRendering als u de standaardwaarde voor WindowsFormsApplicationBase.UseCompatibleTextRendering in Visual Basic 2005 of hoger wilt instellen.
Voor C#-apps voegt Visual Studio automatisch een aanroep toe aan SetCompatibleTextRenderingDefault in het bestand Program.cs. Als u de standaardtekstweergave wilt wijzigen, wijzigt u de gegenereerde code.
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());
}
}
Opmerkingen
Bepaalde Windows Forms besturingselementen kunnen hun tekst weergeven met behulp van de klasse TextRenderer, die is gebaseerd op de GDI-grafische bibliotheek of de Graphics-klasse, die is gebaseerd op de GDI+-grafische bibliotheek. Deze wijziging is aangebracht in .NET Framework 2.0 vanwege prestatie- en lokalisatieproblemen met GDI+. Hiermee SetCompatibleTextRenderingDefault stelt u de standaardwaarde van de UseCompatibleTextRendering eigenschap in voor besturingselementen die die eigenschap ondersteunen.
De eigenschap UseCompatibleTextRendering is bedoeld om visuele compatibiliteit te bieden tussen Windows Forms besturingselementen waarmee tekst wordt weergegeven met behulp van de klasse TextRenderer en apps die aangepaste tekstweergave uitvoeren met behulp van de klasse Graphics. In de meeste gevallen wordt aanbevolen dat u de standaardwaarde van UseCompatibleTextRendering.false
De GDI-klasse TextRenderer is geïntroduceerd in .NET Framework 2.0 om de prestaties te verbeteren, tekst er beter uit te laten zien en ondersteuning voor internationale lettertypen te verbeteren. In eerdere versies van .NET Framework werd de GDI+-klasse Graphics gebruikt om alle tekstweergaven uit te voeren. GDI berekent tekenafstand en tekstterugloop anders dan GDI+. In een Windows Forms toepassing die gebruikmaakt van de klasse Graphics om tekst weer te geven, kan dit ertoe leiden dat de tekst voor besturingselementen die TextRenderer gebruiken, anders lijkt dan de andere tekst in de toepassing. Als u deze incompatibiliteit wilt oplossen, kunt u de UseCompatibleTextRendering eigenschap instellen op true. Als u wilt instellen UseCompatibleTextRendering op true alle ondersteunde besturingselementen in de toepassing, roept u de SetCompatibleTextRenderingDefault methode aan met een argument van true.
U moet deze methode nooit aanroepen als uw Windows Forms code wordt gehost in een andere toepassing, zoals Internet Explorer. Roep deze methode alleen aan in zelfstandige Windows Forms toepassingen.
