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