Application.SetCompatibleTextRenderingDefault(Boolean) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Beállítja az alkalmazásszintű alapértelmezett beállítást az UseCompatibleTextRendering egyes vezérlőkön definiált tulajdonsághoz.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)Paraméterek
- defaultValue
- Boolean
Az új vezérlőkhöz használandó alapértelmezett érték. Ha true, az új vezérlők támogatják UseCompatibleTextRendering a GDI+ alapú Graphics osztályt a szövegmegjelenítéshez; ha false, akkor az új vezérlők a GDI-alapú TextRenderer osztályt használják.
Kivételek
Ezt a metódust csak az első ablak Windows Forms alkalmazás általi létrehozása előtt hívhatja meg.
Példák
Important
A UseCompatibleTextRendering alapértelmezett értékének 2005-ös vagy újabb Visual Basic való beállításához lásd: WindowsFormsApplicationBase.UseCompatibleTextRendering.
C#-alkalmazások esetén Visual Studio automatikusan hozzáad egy hívást SetCompatibleTextRenderingDefault a Program.cs fájlban. A szövegmegjelenítés alapértelmezett értékének módosításához módosítsa a létrehozott kódot.
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());
}
}
Megjegyzések
Bizonyos Windows Forms vezérlők a szövegüket a GDI grafikus kódtáron alapuló TextRenderer osztály vagy a GDI+ grafikus kódtáron alapuló Graphics osztály használatával jeleníthetik meg. Ez a módosítás a .NET Framework 2.0-s verziójában történt a GDI+ teljesítményével és honosításával kapcsolatos problémák miatt. A tulajdonság alapértelmezett értékének beállítására használható SetCompatibleTextRenderingDefault a UseCompatibleTextRendering tulajdonságot támogató vezérlők esetében.
A UseCompatibleTextRendering tulajdonság vizuális kompatibilitást biztosít a TextRenderer osztályt használó szöveget megjelenítő Windows Forms vezérlők és az egyéni szöveg renderelést végző alkalmazások között a Graphics osztály használatával. A legtöbb esetben javasoljuk, hogy UseCompatibleTextRendering hagyja meg a beállítás alapértelmezett értékét false.
A GDI-alapú TextRenderer osztály a .NET Framework 2.0-ban lett bevezetve a teljesítmény javítása, a szöveg jobb megjelenésének és a nemzetközi betűtípusok támogatásának javítása érdekében. A .NET Framework korábbi verzióiban a GDI+ alapú Graphics osztályt használták az összes szövegmegjelenítés végrehajtásához. A GDI a GDI+-tól eltérően számítja ki a karakterközt és a szóburkolást. Egy Windows Forms alkalmazásban, amely a Graphics osztályt használja a szöveg megjelenítéséhez, az TextRenderer-t használó vezérlők szövege eltérhet az alkalmazás többi szövegétől. Az inkompatibilitás feloldásához állítsa a tulajdonságot a UseCompatibleTextRendering következőre true: . Az alkalmazás összes támogatott vezérlőjének beállításához UseCompatibleTextRenderingtrue hívja meg a SetCompatibleTextRenderingDefault metódust a következő argumentummal true: .
Soha ne hívja meg ezt a metódust, ha a Windows Forms kód egy másik alkalmazásban, például Internet Explorer található. Ezt a metódust csak különálló Windows Forms alkalmazásokban hívhatja meg.
