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

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(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  RectF              *boundingBox,
  INT                *codepointsFitted,
  INT                *linesFilled
);

Paramètres

string

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.

length

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.

font

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

layoutRect

Référence au rectangle qui lie la chaîne.

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.

boundingBox

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

codepointsFitted

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

linesFilled

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

Valeur retournée

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 .

Notes

Exemples

L’exemple suivant mesure la taille d’une chaîne, puis dessine un rectangle qui représente cette taille.

VOID Example_MeasureString2(HDC hdc)
{
   Graphics graphics(hdc);
   // Set up the string.
   WCHAR string[] = L"Measure Text";
   Font font(L"Arial", 16);
   RectF layoutRect(0.0f, 0.0f, 100.0f, 50.0f);
   StringFormat format;
   format.SetAlignment(StringAlignmentFar);
   RectF boundRect;
   // Measure the string.
   graphics.MeasureString(string, 12, &font, layoutRect, &format, &boundRect);
   // Draw a rectangle that represents the size of the string.
   graphics.DrawRectangle(&Pen(Color(255, 0, 0, 0)), boundRect);
}

Configuration requise

En-tête	gdiplusgraphics.h

Voir aussi

DrawString, méthodes

Police

Graphismes

RectF

StringFormat