Partager via


StringFormatFlags, énumération (gdiplusenums.h)

L’énumération StringFormatFlags spécifie des informations de disposition de texte (telles que l’orientation et la capture) et affiche des manipulations (telles que l’insertion de points de suspension, la substitution de chiffres et la représentation de caractères qui ne sont pas pris en charge par une police).

Syntaxe

typedef enum StringFormatFlags {
  StringFormatFlagsDirectionRightToLeft = 0x00000001,
  StringFormatFlagsDirectionVertical = 0x00000002,
  StringFormatFlagsNoFitBlackBox = 0x00000004,
  StringFormatFlagsDisplayFormatControl = 0x00000020,
  StringFormatFlagsNoFontFallback = 0x00000400,
  StringFormatFlagsMeasureTrailingSpaces = 0x00000800,
  StringFormatFlagsNoWrap = 0x00001000,
  StringFormatFlagsLineLimit = 0x00002000,
  StringFormatFlagsNoClip = 0x00004000,
  StringFormatFlagsBypassGDI = 0x80000000
} ;

Constants

 
StringFormatFlagsDirectionRightToLeft
Valeur : 0x00000001
Spécifie que l’ordre de lecture est de droite à gauche. Pour le texte horizontal, les caractères sont lus de droite à gauche. Pour le texte vertical, les colonnes sont lues de droite à gauche. Par défaut, le texte horizontal ou vertical est lu de gauche à droite.
StringFormatFlagsDirectionVertical
Valeur : 0x00000002
Spécifie que des lignes de texte individuelles sont dessinées verticalement sur l’appareil d’affichage. Par défaut, les lignes de texte sont horizontales, chaque nouvelle ligne sous la ligne précédente.
StringFormatFlagsNoFitBlackBox
Valeur : 0x00000004
Spécifie que les parties de caractères sont autorisées à surplomber le rectangle de disposition de la chaîne. Par défaut, les caractères sont d’abord alignés à l’intérieur des limites du rectangle, puis tous les caractères qui continuent de surplomber les limites sont repositionnés pour éviter tout surplomb et ainsi éviter d’affecter les pixels en dehors du rectangle de disposition. Une lettre italique minuscule F (f) est un exemple de caractère qui peut avoir des parties en surplomb. La définition de cet indicateur garantit que le caractère s’aligne visuellement avec les lignes ci-dessus et ci-dessous, mais peut provoquer des parties de caractères, qui se trouvent en dehors du rectangle de disposition, à être clippés ou peints.
StringFormatFlagsDisplayFormatControl
Valeur : 0x00000020
Spécifie que les caractères de contrôle de disposition Unicode sont affichés avec un caractère représentatif.
StringFormatFlagsNoFontFallback
Valeur : 0x00000400
Spécifie qu’une autre police est utilisée pour les caractères qui ne sont pas pris en charge dans la police demandée. Par défaut, tous les caractères manquants sont affichés avec le caractère « polices manquantes », généralement un carré ouvert.
StringFormatFlagsMeasureTrailingSpaces
Valeur : 0x00000800
Spécifie que l’espace à la fin de chaque ligne est inclus dans une mesure de chaîne. Par défaut, le rectangle de limite retourné par le
La méthode Graphics ::MeasureString exclut l’espace à la fin de chaque ligne. Définissez cet indicateur pour inclure cet espace dans la mesure.
StringFormatFlagsNoWrap
Valeur : 0x00001000
Spécifie que l’habillage du texte sur la ligne suivante est désactivé. NoWrap est implicite lorsqu’un point d’origine est utilisé au lieu d’un rectangle de disposition. Lorsque vous dessinez du texte dans un rectangle, par défaut, le texte est rompu au dernier mot qui se trouve à l’intérieur de la limite du rectangle et encapsulé à la ligne suivante.
StringFormatFlagsLineLimit
Valeur : 0x00002000
Spécifie que seules les lignes entières sont disposées dans le rectangle de disposition. Par défaut, la disposition se poursuit jusqu’à la fin du texte ou jusqu’à ce qu’aucune ligne supplémentaire ne soit visible à la suite d’un découpage, selon ce qui se produit en premier. Les paramètres par défaut permettent à la dernière ligne d’être partiellement masquée par un rectangle de disposition qui n’est pas un multiple entier de la hauteur de ligne. Pour vous assurer que seules les lignes entières sont vues, définissez cet indicateur et veillez à fournir un rectangle de disposition au moins aussi haut que la hauteur d’une ligne.
StringFormatFlagsNoClip
Valeur : 0x00004000
Spécifie que les caractères surplombant le rectangle de disposition et le texte qui s’étendent en dehors du rectangle de disposition sont autorisés à s’afficher. Par défaut, tous les caractères en surplomb et le texte qui s’étend en dehors du rectangle de disposition sont clippés. Tous les espaces de fin (espaces situés à la fin d’une ligne) qui s’étendent en dehors du rectangle de disposition sont clippés. Par conséquent, le paramètre de cet indicateur aura un effet sur une mesure de chaîne si les espaces de fin sont inclus dans la mesure. Si la capture est activée, les espaces de fin qui s’étendent en dehors du rectangle de disposition ne sont pas inclus dans la mesure. Si le découpage est désactivé, tous les espaces de fin sont inclus dans la mesure, qu’ils se trouvent en dehors du rectangle de disposition.
StringFormatFlagsBypassGDI
Valeur : 0x80000000

Remarques

Plusieurs indicateurs définis peuvent produire des effets combinés :

  • Lorsque StringFormatFlagsDirectionVertical et StringFormatFlagsDirectionRightToLeft sont définis, des lignes de texte individuelles sont dessinées verticalement. La première ligne commence au bord droit du rectangle de disposition ; la deuxième ligne de texte est à gauche de la première ligne, et ainsi de suite.
  • Lorsque StringFormatFlagsDirectionVertical est défini et Que StringFormatFlagsDirectionRightToLeft n’est pas défini, les lignes de texte individuelles sont dessinées verticalement. La première ligne commence au bord gauche du rectangle de disposition ; la deuxième ligne de texte est à droite de la première ligne.
  • Lorsque StringFormatFlagsDirectionRightToLeft est défini et StringFormatFlagsDirectionVertical n’est pas défini, les lignes de texte individuelles sont horizontales et l’ordre de lecture est de droite à gauche. Ce paramètre ne modifie pas l’ordre dans lequel les caractères sont affichés, il spécifie simplement l’ordre dans lequel les caractères peuvent être lus.
Les indicateurs StringFormatFlagsDirectionVertical et StringFormatFlagsDirectionRightToLeft peuvent affecter l’alignement des chaînes.

Spécifications

Requirement Valeur
Client minimum requis Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Header gdiplusenums.h (include Gdiplus.h)

Voir aussi

DrawString, méthodes

Mise en forme du texte

Méthodes MeasureString

StringAlignment

StringDigitSubstitute

StringFormat ::SetFormatFlags

StringTrimming