Graphics ::MeasureString(constWCHAR,INT,constFont,constSizeF&,constStringFormat,SizeF,INT,INT,INT*) (gdiplusgraphics.h)

Article
01/10/2024

La méthode Graphics ::MeasureString mesure l’étendue de la chaîne dans la police, le format et le rectangle de disposition spécifiés.

Syntaxe

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

Paramètres

[in] string

Type : const WCHAR*

Pointeur vers une chaîne de caractères larges à mesurer.

Important Pour les langues bidirectionnelles, telles que l’arabe, la longueur de chaîne ne doit pas dépasser 2 046 caractères.

[in] length

Type : INT

Entier qui spécifie le nombre de caractères dans le tableau de chaînes . Le paramètre length peut être défini sur –1 si la chaîne est terminée par null.

[in] font

Type : const Font*

Pointeur vers un objet Font qui spécifie le nom de famille, la taille et le style de la police appliquée à la chaîne.

[in, ref] layoutRectSize

Type : const SizeF

Référence à un objet SizeF qui spécifie la largeur et la hauteur d’un rectangle qui limite la chaîne.

[in] stringFormat

Type : const StringFormat*

Pointeur vers un objet StringFormat qui spécifie les informations de disposition, telles que l’alignement, le découpage, les taquets de tabulation, etc.

[out] size

Type : SizeF*

Pointeur vers un objet SizeF qui reçoit la largeur et la hauteur du rectangle qui limite la chaîne.

[out] codepointsFitted

Type : INT*

facultatif. Pointeur vers un INT qui reçoit le nombre de caractères qui s’intègrent réellement dans le rectangle de disposition. La valeur par défaut est un pointeur NULL .

[out] linesFilled

Type : INT*

facultatif. Pointeur vers un INT qui reçoit le nombre de lignes qui tiennent réellement dans le rectangle de disposition. La valeur par défaut est un pointeur NULL .

Valeur retournée

Type : État

Si la méthode réussit, elle retourne OK, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Configuration requise


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]
Plateforme cible	Windows
En-tête	gdiplusgraphics.h (inclure Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll