TextFormatFlags Énumération

Définition

Spécifie les informations d’affichage et de disposition pour les 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

Nom Valeur Description
Default 0

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

GlyphOverhangPadding 0

Ajoute le remplissage au rectangle englobant pour prendre en charge les glyphes en surplomb. Il s’agit de la valeur par défaut.

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.

Top 0

Aligne le texte en haut du rectangle englobant. Il s’agit de la valeur par défaut.

HorizontalCenter 1

Centre le texte horizontalement dans le rectangle englobant.

Right 2

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

VerticalCenter 4

Centre le texte verticalement, dans le rectangle englobant.

Bottom 8

Aligne le texte en bas du rectangle englobant. Appliqué uniquement lorsque le texte est une seule ligne.

WordBreak 16

Interrompt le texte à la fin d’un mot.

SingleLine 32

Affiche le texte d’une seule ligne.

ExpandTabs 64

Développe les caractères d’onglet. Le nombre par défaut de caractères par onglet est de huit. Les WordEllipsisvaleurs et EndEllipsis les valeurs PathEllipsisne peuvent pas être utilisées avec ExpandTabs.

NoClipping 256

Permet aux parties de glyphes en surplomb et au texte décompressé qui atteignent l’extérieur du rectangle de mise en forme à afficher.

ExternalLeading 512

Inclut la police externe en hauteur de ligne. En règle générale, le début externe n’est pas inclus dans la hauteur d’une ligne de texte.

NoPrefix 2048

Désactive le traitement des caractères de préfixe. En règle générale, le caractère mnémonique (&) 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-ampersand (&) comme une directive pour imprimer un seul ampersand. En spécifiant NoPrefix, ce traitement est désactivé. Par exemple, une chaîne d’entrée de « A&bc&d » avec NoPrefix application entraînerait la sortie de « A&bc&d ». Comparer avec PrefixOnly.

Internal 4096

Utilise la police système pour calculer les métriques de texte.

TextBoxControl 8192

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

PathEllipsis 16384

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

EndEllipsis 32768

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

ModifyString 65536

N’a aucun effet sur les mesures de texte ou de texte dessinées. 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 elle PathEllipsis est spécifiée.

RightToLeft 131072

Affiche le texte de droite à gauche.

WordEllipsis 262144

Supprime la ligne du mot le plus proche et un point de suspension est placé à la fin d’une ligne rognée. Comparer avec EndEllipsis et PathEllipsis.

NoFullWidthCharacterBreak 524288

Valeur héritée qui n’a aucun effet. Il empêche un saut de ligne à une chaîne de caractères double large, de sorte que la règle de rupture de ligne équivaut à celle des chaînes de caractères à un seul niveau.

HidePrefix 1048576

Ignore le caractère de préfixe d’ampersand (&) 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.

PrefixOnly 2097152

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

PreserveGraphicsClipping 16777216

Conserve le découpage spécifié par un Graphics objet. S’applique uniquement aux méthodes recevant un IDeviceContext élément qui est un Graphics.

PreserveGraphicsTranslateTransform 33554432

Conserve la transformation spécifiée par un Graphics. S’applique uniquement aux méthodes recevant un IDeviceContext élément qui est un Graphics.

NoPadding 268435456

N’ajoute pas de remplissage au rectangle englobant.

LeftAndRightPadding 536870912

Ajoute un remplissage aux deux côtés du rectangle englobant.

Exemples

L’exemple suivant montre comment utiliser l’énumération TextFormatFlags . Pour exécuter cet exemple, collez le code suivant dans un formulaire Windows. Appel RenderText6 à partir du gestionnaire d’événements du Paint formulaire, en passant e en tant que 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 dessin et la TextRenderer mesure du texte. L’option 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 .

S’applique à

Voir aussi