Graphics::MeasureString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,RectF*,INT*,INT*)-Methode (gdiplusgraphics.h)
Die Graphics::MeasureString-Methode misst den Umfang der Zeichenfolge im angegebenen Schriftart-, Format- und Layoutrechteck.
Syntax
Status MeasureString(
const WCHAR *string,
INT length,
const Font *font,
const RectF & layoutRect,
const StringFormat *stringFormat,
RectF *boundingBox,
INT *codepointsFitted,
INT *linesFilled
);
Parameter
string
Zeiger auf eine breit zu messende Zeichenfolge.
Wichtig Bei bidirektionalen Sprachen, z. B. Arabisch, darf die Zeichenfolgenlänge 2046 Zeichen nicht überschreiten.
length
Ganzzahl, die die Anzahl der Zeichen im Zeichenfolgenarray angibt. Der Längenparameter kann auf -1 festgelegt werden, wenn die Zeichenfolge null beendet ist.
font
Zeiger auf ein Font-Objekt , das den Familiennamen, die Größe und den Stil der Schriftart angibt, die auf die Zeichenfolge angewendet werden soll.
layoutRect
Verweis auf das Rechteck, das die Zeichenfolge umgrenzt.
stringFormat
Zeiger auf ein StringFormat-Objekt , das die Layoutinformationen angibt, z. B. Ausrichtung, Kürzen, Tabstopps usw.
boundingBox
Zeiger auf ein RectF-Objekt , das das Rechteck empfängt, das die Zeichenfolge umgrenzt.
codepointsFitted
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 .
linesFilled
Optional. Zeiger auf einen INT , der die Anzahl der Zeilen empfängt, die in das Layoutrechteck passen. Der Standardwert ist ein NULL-Zeiger .
Rückgabewert
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.
Bemerkungen
Beispiele
Das folgende Beispiel misst die Größe einer Zeichenfolge und zeichnet dann ein Rechteck, das diese Größe darstellt.
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);
}
Anforderungen
| Kopfzeile | gdiplusgraphics.h |