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

Weitere Informationen

DrawString-Methoden

Schriftart

Grafiken

RectF

StringFormat