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 |