Application.SetCompatibleTextRenderingDefault(Boolean) Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Définit la valeur par défaut à l’échelle de l’application pour la UseCompatibleTextRendering propriété définie sur certains contrôles.

public:
 static void SetCompatibleTextRenderingDefault(bool defaultValue);
public static void SetCompatibleTextRenderingDefault(bool defaultValue);
static member SetCompatibleTextRenderingDefault : bool -> unit
Public Shared Sub SetCompatibleTextRenderingDefault (defaultValue As Boolean)

Paramètres

defaultValue
Boolean

Valeur par défaut à utiliser pour les nouveaux contrôles. Si true, les nouveaux contrôles qui prennent en charge UseCompatibleTextRendering l’utilisation de la classe GDI+ Graphics pour le rendu de texte ; si false, les nouveaux contrôles utilisent la classe basée sur TextRenderer GDI.

Exceptions

InvalidOperationException

Vous pouvez uniquement appeler cette méthode avant la création de la première fenêtre par votre application Windows Forms.

Exemples

Essentiel

Pour définir la valeur par défaut de UseCompatibleTextRendering dans Visual Basic 2005 ou version ultérieure, consultez WindowsFormsApplicationBase.UseCompatibleTextRendering.

Pour les applications C#, Visual Studio ajoute automatiquement un appel à SetCompatibleTextRenderingDefault dans le fichier Program.cs. Pour modifier la valeur par défaut du rendu du texte, modifiez le code généré.

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());
    }
}

Remarques

Certains contrôles Windows Forms peuvent afficher leur texte à l’aide de la classe TextRenderer, basée sur la bibliothèque graphique GDI, ou de la classe Graphics, basée sur la bibliothèque graphique GDI+. Cette modification a été apportée dans .NET Framework 2.0 en raison de problèmes de performances et de localisation avec GDI+. Permet SetCompatibleTextRenderingDefault de définir la valeur par défaut de la UseCompatibleTextRendering propriété pour les contrôles qui prennent en charge cette propriété.

La propriété UseCompatibleTextRendering est destinée à fournir une compatibilité visuelle entre les contrôles Windows Forms qui affichent du texte à l’aide de la classe TextRenderer et des applications qui effectuent un rendu de texte personnalisé à l’aide de la classe Graphics. Dans la plupart des cas, il est recommandé de conserver UseCompatibleTextRendering la valeur par défaut .false

La classe TextRenderer basée sur GDI a été introduite dans .NET Framework 2.0 pour améliorer les performances, améliorer l’apparence du texte et améliorer la prise en charge des polices internationales. Dans les versions antérieures de .NET Framework, la classe Graphics basée sur GDI+ a été utilisée pour effectuer tout le rendu de texte. GDI calcule l’espacement des caractères et l’habillage de mots différemment de GDI+. Dans une application Windows Forms qui utilise la classe Graphics pour afficher du texte, cela peut entraîner l’affichage du texte pour les contrôles qui utilisent TextRenderer d’apparaître différemment de l’autre texte de l’application. Pour résoudre cette incompatibilité, vous pouvez définir la UseCompatibleTextRendering propriété sur true. Pour définir UseCompatibleTextRendering la valeur pour true tous les contrôles pris en charge dans l’application, appelez la SetCompatibleTextRenderingDefault méthode avec un argument de true.

Vous ne devez jamais appeler cette méthode si votre code Windows Forms est hébergé dans une autre application, par exemple Internet Explorer. Appelez cette méthode uniquement dans les applications autonomes Windows Forms.

S’applique à

Voir aussi