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

Die Graphics::D rawString-Methode zeichnet eine Zeichenfolge basierend auf einer Schriftart und einem Ursprung für die Zeichenfolge.

Syntax

Status DrawString(
  [in]      const WCHAR    *string,
  [in]      INT            length,
  [in]      const Font     *font,
  [in, ref] const PointF & origin,
  [in]      const Brush    *brush
);

Parameter

[in] string

Typ: const WCHAR*

Zeiger auf eine Zeichenfolge, die gezeichnet werden soll.

[in] length

Typ: INT

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

[in, ref] origin

Typ: const PointF

Verweis auf ein PointF-Objekt , das den Ausgangspunkt für die Zeichenfolge angibt.

[in] brush

Typ: const Brush*

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

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

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

Wenn Sie die GDI+-API verwenden, dürfen Sie ihrer Anwendung nicht erlauben, beliebige Schriftarten aus nicht vertrauenswürdigen Quellen herunterzuladen. Das Betriebssystem erfordert erhöhte Berechtigungen, um sicherzustellen, dass alle installierten Schriftarten vertrauenswürdig sind.

Beispiele

Das folgende Beispiel zeichnet eine Zeichenfolge am angegebenen Ursprung.

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

   // Create a string.
   WCHAR string[] = L"Sample Text";

   // Initialize arguments.
   Font myFont(L"Arial", 16);
   PointF origin(0.0f, 0.0f);
   SolidBrush blackBrush(Color(255, 0, 0, 0));

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   origin,
   &blackBrush);
}

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

Schriftart

Grafiken

Graphicspath

Solidbrush