Graphics::MeasureString(constWCHAR*,INT,constFont*,constSizeF&,constStringFormat*,SizeF*,INT*,INT*)-Methode (gdiplusgraphics.h)
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.
[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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für