Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
TextFormatFlags, énumération
Collapse the table of content
Expand the table of content

TextFormatFlags, énumération

Remarque : cette énumération est nouvelle dans le .NET Framework version 2.0.

Spécifie des informations d'affichage et relatives à la disposition pour des chaînes de texte.

Cette énumération possède un attribut FlagsAttribute qui permet la combinaison d'opérations de bits de ses valeurs membres.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

[FlagsAttribute] 
public enum TextFormatFlags
/** @attribute FlagsAttribute() */ 
public enum TextFormatFlags
FlagsAttribute 
public enum TextFormatFlags

 Nom de membreDescription
BottomAligne le texte sur la partie inférieure du rectangle englobant. S'applique uniquement lorsque le texte est une ligne unique. 
DefaultApplique la mise en forme par défaut, qui est alignée à gauche. 
EndEllipsisSupprime la fin des lignes rognées et la remplace par des points de sélection. 
ExpandTabsDéveloppe des caractères de tabulation. Le nombre par défaut de caractères par tabulation est huit. Les valeurs WordEllipsis, PathEllipsis et EndEllipsis ne peuvent pas être utilisées avec ExpandTabs
ExternalLeadingInclut l'espacement externe de la police dans la hauteur de ligne. En général, l'espacement externe n'est pas inclus dans la hauteur d'une ligne de texte. 
GlyphOverhangPaddingAjoute une marge intérieure au rectangle englobant pour prendre en charge les glyphes surplombants.  
HidePrefixS'applique uniquement à Windows 2000 et Windows XP :  

Ignore le caractère de préfixe perluète (&) dans le texte. La lettre qui suit n'est pas soulignée, mais d'autres caractères de préfixe mnémonique sont toujours traités. Par exemple, la chaîne d'entrée "A&bc&&d" avec HidePrefix appliqué génère la sortie "Abc&d".

Comparez à NoPrefix et PrefixOnly.

HorizontalCenterCentre le texte horizontalement dans le rectangle englobant. 
InternalUtilise la police système pour calculer la métrique du texte. 
LeftAligne le texte sur le côté gauche de la zone de découpage. 
LeftAndRightPaddingAjoute une marge intérieure aux deux côtés du rectangle englobant. 
ModifyStringModifie la chaîne spécifiée pour correspondre au texte affiché. Cette valeur reste sans effet à moins que EndEllipsis ou PathEllipsis soit également spécifié. 
NoClippingPermet d'afficher les parties des glyphes surplombants et le texte non renvoyé à la ligne sortant du rectangle de mise en forme. 
NoFullWidthCharacterBreakS'applique uniquement à Windows 98, Windows Me, Windows 2000 ou Windows XP : 

Empêche un saut de ligne dans une chaîne de caractères à largeur double, afin que la règle de saut de ligne soit équivalente aux chaînes de caractères à largeur unique. Par exemple, NoFullWidthCharacterBreak augmente la lisibilité des étiquettes d'icône dans les fenêtres coréennes. Cette valeur reste sans effet à moins que WordBreak soit également spécifié.

NoPaddingN'ajoute pas de marge intérieure au rectangle englobant. 
NoPrefixDésactive le traitement des caractères de préfixe. En général, le caractère de préfixe mnémonique perluète (&) est interprété comme une directive pour souligner le caractère qui suit, et les caractères de préfixe mnémonique double perluète (&&) sont interprétés comme une directive pour imprimer une perluète unique. En spécifiant NoPrefix, ce traitement est désactivé. Par exemple, la chaîne d'entrée "A&bc&&d" avec NoPrefix appliqué génère la sortie "A&bc&&d". 

Comparez à HidePrefix et PrefixOnly.

PathEllipsisSupprime le centre des lignes rognées et le remplace par des points de sélection.  
PrefixOnlyS'applique uniquement à Windows 2000 ou Windows XP :  

Dessine uniquement un trait de soulignement à la position du caractère qui suit le caractère de préfixe perluète (&). Ne dessine pas d'autres caractères dans la chaîne. Par exemple, la chaîne d'entrée "A&bc&&d" génère la sortie " _ ".

Comparez à HidePrefix et NoPrefix.

PreserveGraphicsClippingConserve le découpage spécifié par un objet Graphics. S'applique uniquement aux méthodes qui reçoivent IDeviceContext qui est Graphics
PreserveGraphicsTranslateTransformConserve la transformation spécifiée par Graphics. S'applique uniquement aux méthodes qui reçoivent IDeviceContext qui est Graphics
RightAligne le texte sur le côté droit de la zone de découpage. 
RightToLeftAffiche le texte de droite à gauche. 
SingleLineAffiche le texte dans une ligne unique. 
TextBoxControlSpécifie que le texte doit être mis en forme pour l'affichage sur un contrôle TextBox
TopAligne le texte sur la partie supérieure du rectangle englobant. 
VerticalCenterCentre le texte verticalement dans le rectangle englobant. 
WordBreakArrête le texte à la fin d'un mot. 
WordEllipsisRogne la ligne au mot le plus proche, et des points de sélection sont placés à la fin d'une ligne rognée. 

L'énumération TextFormatFlags est utilisée par TextRenderer lors du dessin et de la mesure du texte. Le TextRenderer ne prend pas en charge l'ajout de taquets de tabulation au texte dessiné, bien que vous puissiez développer les taquets de tabulation existants à l'aide de l'indicateur ExpandTabs.

L'exemple de code suivant illustre l'utilisation de l'énumération TextFormatFlags. Pour exécuter cet exemple, collez le code suivant dans un Windows Form. Appelez RenderText7 à partir du gestionnaire d'événements Paint du formulaire, en passant e comme PaintEventArgs.

private void RenderText6(PaintEventArgs e)
{
    TextFormatFlags flags = TextFormatFlags.Bottom | TextFormatFlags.EndEllipsis;
    TextRenderer.DrawText(e.Graphics, "This is some text that will be clipped at the end.", this.Font,
        new Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags);
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft