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

Artikel
01/10/2024

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 SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

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

Typ: const SizeF

Verweis auf ein SizeF-Objekt , das die Breite und Höhe eines Rechtecks angibt, das die Zeichenfolge umgrenzt.

[in] stringFormat

Typ: const StringFormat*

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

[out] size

Typ: SizeF*

Zeiger auf ein SizeF-Objekt , das die Breite und Höhe des Rechtecks empfängt, das die Zeichenfolge umgrenzt.

[out] codepointsFitted

Typ: INT*

Optional. Zeiger auf ein INT , das die Anzahl der Zeichen empfängt, die tatsächlich in das Layoutrechteck passen. Der Standardwert ist ein NULL-Zeiger .

[out] linesFilled

Typ: INT*

Optional. Zeiger auf einen INT , der die Anzahl der Zeilen empfängt, die tatsächlich in das Layoutrechteck passen. Der Standardwert ist ein NULL-Zeiger .

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