TextFormatFlags Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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 |
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 |
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 |
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 |
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
.