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

Die Graphics::MeasureString-Methode misst den Umfang der Zeichenfolge in der angegebenen Schriftart und dem angegebenen Layoutrechteck.

Syntax

Status MeasureString(
  [in]      const WCHAR   *string,
  [in]      INT           length,
  [in]      const Font    *font,
  [in, ref] const RectF & layoutRect,
  [out]     RectF         *boundingBox
);

Parameter

[in] string

Typ: const WCHAR*

Zeiger auf eine zu messende Breitzeichenzeichenfolge.

Wichtig Bei bidirektionalen Sprachen, z. B. Arabisch, darf die Zeichenfolgenlänge 2046 Zeichen nicht überschreiten.

 

[in] length

Typ: INT

Eine ganze Zahl, die die Anzahl der Zeichen im Zeichenfolgenarray angibt. Der length-Parameter kann auf –1 festgelegt werden, wenn die Zeichenfolge null beendet ist.

[in] font

Typ: const Font*

Zeiger auf ein Font-Objekt , das den Familiennamen, die Größe und den Stil der Schriftart angibt, die auf die Zeichenfolge angewendet wird.

[in, ref] layoutRect

Typ: const RectF

Verweis auf ein Rechteck, das die Zeichenfolge begrenzt.

[out] boundingBox

Typ: RectF*

Zeiger auf ein RectF-Objekt , das das Rechteck empfängt, das die Zeichenfolge umgibt.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll

Weitere Informationen

DrawString-Methoden

Schriftart

Grafiken

RectF