Énumération StringFormatFlags (gdiplusenums.h)

Article
03/01/2024

L’énumération StringFormatFlags spécifie les informations de disposition du texte (telles que l’orientation et le découpage) et les manipulations d’affichage (telles que l’insertion d’ellipses, la substitution de chiffres et la représentation de caractères qui ne sont pas pris en charge par une police).

Syntax

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

Constantes


`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 le périphérique d’affichage. Par défaut, les lignes de texte sont horizontales, chaque nouvelle ligne en dessous de la ligne précédente.
`StringFormatFlagsNoFitBlackBox` Valeur : 0x00000004 Spécifie que des 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 dépassent encore les limites sont repositionnés pour éviter tout surplomb et ainsi éviter d’affecter les pixels en dehors du rectangle de disposition. Une lettre minuscule en italique 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 sur les lignes au-dessus et en dessous, mais peut entraîner le découpage ou la peinture de parties de caractères situés en dehors du rectangle de disposition.
`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 à la ligne suivante est désactivé. NoWrap est implicite lorsqu’un point d’origine est utilisé à la place d’un rectangle de disposition. Lorsque vous dessinez du texte dans un rectangle, par défaut, le texte est rompu à la limite du 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 mise en page 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 la première éventualité. 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 des lignes entières sont visibles, 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 qui dépassent le rectangle de disposition et le texte qui s’étend 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 coupés. Tous les espaces de fin (espaces situés à la fin d’une ligne) qui s’étendent en dehors du rectangle de disposition sont coupés. Par conséquent, la définition de cet indicateur aura un effet sur une mesure de chaîne si des espaces de fin sont inclus dans la mesure. Si le découpage est activé, 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 soient ou non 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 se trouve à 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 se trouve à droite de la première ligne.
Lorsque StringFormatFlagsDirectionRightToLeft est défini et Que 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	gdiplusenums.h (include Gdiplus.h)