Application.SetCompatibleTextRenderingDefault(Boolean) Méthode

  • Référence

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 la valeur est true, les nouveaux contrôles qui prennent en charge UseCompatibleTextRendering utilisent la classe basée sur Graphics GDI+ pour le rendu du texte ; si false, les nouveaux contrôles utilisent la classe basée sur TextRenderer GDI.

Exceptions

InvalidOperationException

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

Exemples

Important

Pour définir la valeur par défaut pour 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 le rendu de texte par défaut, 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 TextRenderer classe , qui est basée sur la bibliothèque graphique GDI, ou de la Graphics classe , qui est basée sur la bibliothèque de graphiques 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 UseCompatibleTextRendering propriété est destinée à assurer la compatibilité visuelle entre Windows Forms contrôles qui restituent le texte à l’aide de la TextRenderer classe et les applications qui effectuent un rendu de texte personnalisé à l’aide de la Graphics classe . Dans la plupart des cas, si votre application n’est pas mise à niveau à partir de .NET Framework 1.0 ou .NET Framework 1.1, il est recommandé de laisser UseCompatibleTextRendering défini sur la valeur par défaut de false.

La classe basée sur TextRenderer 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 basée sur Graphics GDI+ était utilisée pour effectuer tout le rendu du texte. GDI calcule l’espacement des caractères et l’habillage des mots différemment de GDI+. Dans une application Windows Forms qui utilise la Graphics classe pour afficher du texte, le texte des contrôles qui utilisent TextRenderer peut apparaître différent de l’autre texte de l’application. Pour résoudre cette incompatibilité, vous pouvez définir la propriété sur UseCompatibleTextRenderingtrue. Pour définir UseCompatibleTextRendering sur true pour 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, telle qu’Internet Explorer. Appelez cette méthode uniquement dans les applications Windows Forms autonomes.

S’applique à

Voir aussi