TextFormatFlags Énumération

Définition

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

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class TextFormatFlags
[System.Flags]
public enum TextFormatFlags
[<System.Flags>]
type TextFormatFlags = 
Public Enum TextFormatFlags
Héritage
TextFormatFlags
Attributs

Champs

Bottom 8

Aligne le texte sur la partie inférieure du rectangle englobant. S'applique uniquement lorsque le texte est une ligne unique.

Default 0

Applique la mise en forme par défaut, qui est alignée à gauche.

EndEllipsis 32768

Supprime la fin des lignes rognées et la remplace par des points de sélection. Lorsqu’elle est utilisée pour dessiner du texte par TextRenderer, la chaîne n’est pas modifiée, sauf si l’indicateur ModifyString est spécifié. Comparez avec PathEllipsis et WordEllipsis.

ExpandTabs 64

Dé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.

ExternalLeading 512

Inclut 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.

GlyphOverhangPadding 0

Ajoute une marge intérieure au rectangle englobant pour prendre en charge les glyphes surplombants. Il s’agit de la valeur par défaut.

HidePrefix 1048576

Ignore le caractère de préfixe esperluette (&) dans le texte, afin que la lettre qui suit ne soit pas soulignée, mais d’autres caractères de préfixe mnémonique sont toujours traités.

HorizontalCenter 1

Centre le texte horizontalement dans le rectangle englobant.

Internal 4096

Utilise la police système pour calculer la métrique du texte.

Left 0

Aligne le texte sur le côté gauche de la zone de découpage. Il s’agit de la valeur par défaut.

LeftAndRightPadding 536870912

Ajoute une marge intérieure aux deux côtés du rectangle englobant.

ModifyString 65536

N’a aucun effet sur le texte dessiné ou les mesures de texte. Lorsqu’il est utilisé pour dessiner du texte par TextRenderer, modifie le paramètre de chaîne spécifié pour qu’il corresponde au texte affiché si des points de suspension sont affichés. Cette valeur n’a aucun effet sauf si EndEllipsis ou PathEllipsis est spécifié.

NoClipping 256

Permet d'afficher les parties des glyphes surplombants et le texte non renvoyé à la ligne sortant du rectangle de mise en forme.

NoFullWidthCharacterBreak 524288

Valeur héritée qui n’a aucun effet. Empêche les sauts de ligne après une chaîne de deux caractères larges. La règle de saut de ligne équivaut donc à celle valable pour un seul caractère large.

NoPadding 268435456

N'ajoute pas de marge intérieure au rectangle englobant.

NoPrefix 2048

Désactive le traitement des caractères de préfixe. En règle générale, le caractère préfixe mnémonique (&) est interprété comme une directive pour souligner le caractère qui suit, et les caractères de préfixe mnémonique double-esperluette (&&) en tant que directive pour imprimer une seule esperluette. En spécifiant NoPrefix, ce traitement est désactivé. Par exemple, une chaîne d’entrée « A&bc&&d » avec NoPrefix appliquée génère la sortie « A&bc&&d ». Comparez avec PrefixOnly.

PathEllipsis 16384

Supprime le centre des lignes rognées et le remplace par des points de sélection. Lorsqu’elle est utilisée pour dessiner du texte par TextRenderer, la chaîne n’est pas modifiée, sauf si l’indicateur ModifyString est spécifié. Comparez avec EndEllipsis et WordEllipsis.

PrefixOnly 2097152

Dessine uniquement un trait de soulignement à la position du caractère suivant le caractère de préfixe d’esperluette (&) et ne dessine aucun autre caractère dans la chaîne.

PreserveGraphicsClipping 16777216

Conserve le découpage spécifié par un objet Graphics. S'applique uniquement aux méthodes qui reçoivent IDeviceContext qui est Graphics.

PreserveGraphicsTranslateTransform 33554432

Conserve la transformation spécifiée par Graphics. S'applique uniquement aux méthodes qui reçoivent IDeviceContext qui est Graphics.

Right 2

Aligne le texte sur le côté droit de la zone de découpage.

RightToLeft 131072

Affiche le texte de droite à gauche.

SingleLine 32

Affiche le texte dans une ligne unique.

TextBoxControl 8192

Spécifie que le texte doit être mis en forme pour l'affichage sur un contrôle TextBox.

Top 0

Aligne le texte sur la partie supérieure du rectangle englobant. Il s’agit de la valeur par défaut.

VerticalCenter 4

Centre le texte verticalement dans le rectangle englobant.

WordBreak 16

Arrête le texte à la fin d'un mot.

WordEllipsis 262144

Rogne la ligne au mot le plus proche, et des points de sélection sont placés à la fin d'une ligne rognée. Comparez avec EndEllipsis et PathEllipsis.

Exemples

L’exemple suivant montre comment utiliser l’énumération TextFormatFlags . Pour exécuter cet exemple, collez le code suivant dans un Windows Form. Appelez RenderText6 à partir du gestionnaire d’événements du Paint 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);
}
Private Sub RenderText6(ByVal e As PaintEventArgs)
    Dim flags As TextFormatFlags = TextFormatFlags.Bottom Or _
        TextFormatFlags.EndEllipsis
    TextRenderer.DrawText(e.Graphics, _
    "This is some text that will be clipped at the end.", _
    Me.Font, New Rectangle(10, 10, 100, 50), SystemColors.ControlText, flags)

End Sub

Remarques

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

S’applique à

Voir aussi