Application.SetCompatibleTextRenderingDefault(Boolean) Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Nastaví výchozí nastavení pro celou aplikaci pro vlastnost definovanou UseCompatibleTextRendering u určitých ovládacích prvků.

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

Výchozí hodnota, která se má použít pro nové ovládací prvky. Pokud true, nové ovládací prvky, které podporují UseCompatibleTextRendering , používají pro vykreslování textu třídu založenou na Graphics rozhraní GDI+; pokud false, nové ovládací prvky používají třídu založenou na TextRenderer rozhraní GDI.

Výjimky

InvalidOperationException

Tuto metodu můžete volat pouze před vytvořením prvního okna vaší model Windows Forms aplikací.

Příklady

Důležité

Pokud chcete nastavit výchozí hodnotu pro UseCompatibleTextRendering v jazyce Visual Basic 2005 nebo novějším, přečtěte si téma WindowsFormsApplicationBase.UseCompatibleTextRendering.

U aplikací jazyka C# sada Visual Studio automaticky přidá volání SetCompatibleTextRenderingDefault do 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é model Windows Forms ovládací prvky mohou vykreslit text buď TextRenderer pomocí třídy, která je založená na grafické knihovně GDI, nebo Graphics třídy, která je založená 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 je určena UseCompatibleTextRendering k zajištění vizuální kompatibility mezi model Windows Forms ovládacími prvky, které vykreslují text pomocí TextRenderer třídy, a aplikacemi, které provádějí vlastní vykreslování textu pomocí Graphics třídy . Ve většině případů, pokud se vaše aplikace neupgraduje z rozhraní .NET Framework 1.0 nebo .NET Framework 1.1, doporučujeme nechat UseCompatibleTextRendering nastavenou výchozí hodnotu false.

Třída založená na TextRenderer rozhraní GDI byla zavedena v rozhraní .NET Framework 2.0 za účelem zlepšení výkonu, lepšího vzhledu textu a podpory mezinárodních písem. V dřívějších verzích rozhraní .NET Framework byla třída založená na Graphics rozhraní GDI+ použita k vykreslení veškerého textu. Rozhraní GDI počítá proložení znaků a zalamování slov odlišně od rozhraní GDI+. V aplikaci model Windows Forms, která používá Graphics třídu k vykreslení textu, to může způsobit, že text ovládacích prvků, které používajíTextRenderer, se zobrazí jinak než ostatní text v aplikaci. Pokud chcete tuto nekompatibilitu vyřešit, můžete vlastnost nastavit UseCompatibleTextRendering na true. Pokud chcete nastavit UseCompatibleTextRendering na true pro všechny podporované ovládací prvky v aplikaci, zavolejte metodu SetCompatibleTextRenderingDefault s argumentem true.

Tuto metodu byste nikdy neměli volat, pokud je kód model Windows Forms hostovaný v jiné aplikaci, jako je například Internet Explorer. Tuto metodu volejte pouze v samostatných aplikacích model Windows Forms.

Platí pro

Viz také