Graphics ::MeasureString(constWCHAR*,INT,constFont*,constRectF&,RectF*) (gdiplusgraphics.h)

  • Article

La méthode Graphics ::MeasureString mesure l’étendue de la chaîne dans la police 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 RectF & layoutRect,
  [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] layoutRect

Type : const RectF

Référence à un rectangle qui limite la chaîne.

[out] boundingBox

Type : RectF*

Pointeur vers un objet RectF qui reçoit le rectangle qui limite 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

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

Voir aussi

Méthodes DrawString

Police

Graphismes

RectF