Graphics::D rawString(constWCHAR*,INT,constFont*,constRectF&,constStringFormat*,constBrush*)-Methode (gdiplusgraphics.h)

Die Graphics::D rawString-Methode zeichnet eine Zeichenfolge basierend auf einer Schriftart, einem Layoutrechteck und einem Format.

Syntax

Status DrawString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  const Brush        *brush
);

Parameter

string

Zeiger auf eine breit zu zeichnende Zeichenfolge.

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 die zu verwendenden Schriftartattribute (den Familiennamen, die Größe und den Stil der Schriftart) angibt.

layoutRect

Verweis auf ein Rechteck, das die Zeichenfolge umgrenzt.

stringFormat

Zeiger auf ein StringFormat-Objekt , das Textlayoutinformationen und Anzeigebearbeitungen angibt, die auf die Zeichenfolge angewendet werden sollen.

brush

Zeiger auf ein Brush-Objekt , das zum Füllen der Zeichenfolge verwendet wird.

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.

Hinweise

Beachten Sie, dass GDI+ keine PostScript- oder OpenType-Schriftarten unterstützt, die keine TrueType-Gliederungen aufweisen.

Wenn Sie die GDI+-API verwenden, dürfen Sie nicht zulassen, dass Ihre Anwendung beliebige Schriftarten aus nicht vertrauenswürdigen Quellen herunter lädt. Das Betriebssystem erfordert erhöhte Berechtigungen, um sicherzustellen, dass alle installierten Schriftarten vertrauenswürdig sind.

Beispiele

Im folgenden Beispiel wird die angegebene Formatierung verwendet, um eine Zeichenfolge in einem Layoutrechteck zu zeichnen.

VOID Example_DrawString(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a string.
   WCHAR string[] = L"Sample Text";
   
   // Initialize arguments.
   Font myFont(L"Arial", 16);
   RectF layoutRect(0.0f, 0.0f, 200.0f, 50.0f);
   StringFormat format;
   format.SetAlignment(StringAlignmentCenter);
   SolidBrush blackBrush(Color(255, 0, 0, 0));

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   layoutRect,
   &format,
   &blackBrush);

   // Draw layoutRect.
   graphics.DrawRectangle(&Pen(Color::Black, 3), layoutRect);
}

Anforderungen

Kopfzeile	gdiplusgraphics.h

Weitere Informationen

Grafiken

Schriftart

Stift

RectF

StringFormat