Application.SetCompatibleTextRenderingDefault(Boolean) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nastaví výchozí nastavení pro vlastnost definovanou UseCompatibleTextRendering v určitých ovládacích prvcích pro celou aplikaci.
public:
static void SetCompatibleTextRenderingDefault(bool defaultValue);public static void SetCompatibleTextRenderingDefault(bool defaultValue);static member SetCompatibleTextRenderingDefault : bool -> unitPublic Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)Parametry
- defaultValue
- Boolean
Výchozí hodnota, která se má použít pro nové ovládací prvky. Pokud true, nové ovládací prvky, které podporují UseCompatibleTextRendering použití GDI+ třídy pro Graphics vykreslování textu; pokud false, nové ovládací prvky používají GDI založenou TextRenderer třídu.
Výjimky
Tuto metodu můžete volat pouze před vytvořením prvního okna vaší model Windows Forms aplikací.
Příklady
Important
Pokud chcete nastavit výchozí hodnotu pro UseCompatibleTextRendering v Visual Basic 2005 nebo novějším, podívejte se na WindowsFormsApplicationBase.UseCompatibleTextRendering.
U aplikací jazyka C# Visual Studio automaticky přidá volání SetCompatibleTextRenderingDefault v souboru Program.cs. Pokud chcete změnit výchozí vykreslování textu, upravte vygenerovaný kód.
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());
}
}
Poznámky
Některé ovládací prvky model Windows Forms mohou vykreslit svůj text pomocí třídy TextRenderer, která je založena na grafické knihovně GDI, nebo třídy Graphics, která je založena na grafické knihovně GDI+. Tato změna byla provedena v rozhraní .NET Framework 2.0 kvůli problémům s výkonem a lokalizací rozhraní GDI+. Slouží SetCompatibleTextRenderingDefault k nastavení výchozí hodnoty UseCompatibleTextRendering vlastnosti pro ovládací prvky, které tuto vlastnost podporují.
Vlastnost UseCompatibleTextRendering je určena k zajištění vizuální kompatibility mezi ovládacími prvky model Windows Forms, které vykreslují text pomocí třídy TextRenderer a aplikací, které provádějí vlastní vykreslování textu pomocí třídy Graphics. Ve většině případů se doporučuje nechat UseCompatibleTextRendering nastavenou výchozí hodnotu false.
Třída založená na GDI TextRenderer byla zavedena v .NET Framework 2.0, aby se zlepšil výkon, lépe vypadal text a zlepšila podpora mezinárodních písem. V dřívějších verzích .NET Framework se ke všem vykreslování textu použila třída GDI+ založená na Graphics. GDI vypočítá mezery mezi znaky a obtékání slov odlišně od GDI+. V aplikaci model Windows Forms, která používá třídu Graphics k vykreslení textu, může to způsobit, že text ovládacích prvků, které používají TextRenderer, se budou lišit od druhého textu v aplikaci. Chcete-li tuto nekompatibilitu vyřešit, můžete vlastnost nastavit UseCompatibleTextRendering na truehodnotu . Chcete-li nastavit UseCompatibleTextRendering pro true všechny podporované ovládací prvky v aplikaci, zavolejte SetCompatibleTextRenderingDefault metodu s argumentem true.
Tuto metodu byste nikdy neměli volat, pokud je kód model Windows Forms hostovaný v jiné aplikaci, například Internet Explorer. Tuto metodu volejte pouze v samostatných model Windows Forms aplikacích.
