Graphics ::MeasureString(constWCHAR,INT,constFont,constPointF&,constStringFormat,RectF) méthode (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 PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [out]     RectF              *boundingBox
);

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] origin

Type : const PointF

Référence au point de démarrage de 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] boundingBox

Type : RectF*

Pointeur vers un objet RectF qui reçoit le rectangle qui lie la chaîne.

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 (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll