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

Artikel
08/24/2023

Die Graphics::MeasureString-Methode misst den Umfang der Zeichenfolge im angegebenen Schriftart-, Format- und Layoutrechteck.

Syntax

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
);

Parameter

[in] string

Typ: const WCHAR*

Zeiger auf eine breit zu messende Zeichenfolge.

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

[in] length

Typ: INT

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

Typ: const PointF

Verweis auf den Punkt, an dem die Zeichenfolge beginnt.

[in] stringFormat

Typ: const StringFormat*

Zeiger auf ein StringFormat-Objekt , das die Layoutinformationen angibt, z. B. Ausrichtung, Kürzen, Tabstopps usw.

[out] boundingBox

Typ: RectF*

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

Rückgabewert

Typ: Status

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

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Anforderungen


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