Graphics::D rawString(constWCHAR*;INT,constFont*,constPointF&,constStringFormat*,constBrush*)-Methode (gdiplusgraphics.h)
Die Graphics::D rawString-Methode zeichnet eine Zeichenfolge basierend auf einer Schriftart, einem Zeichenfolgenursprung und einem Format.
Syntax
Status DrawString(
[in] const WCHAR *string,
[in] INT length,
[in] const Font *font,
[in, ref] const PointF & origin,
[in] const StringFormat *stringFormat,
[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] stringFormat
Typ: const StringFormat*
Zeiger auf ein StringFormat-Objekt , das Textlayoutinformationen und Anzeigebearbeitungen angibt, die auf die Zeichenfolge angewendet werden sollen.
[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
Im folgenden Beispiel wird die angegebene Formatierung verwendet, um eine Zeichenfolge am angegebenen Ursprung zu zeichnen.
VOID Example_DrawString3(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));
StringFormat format;
format.SetAlignment(StringAlignmentCenter);
// Draw string.
graphics.DrawString(
string,
11,
&myFont,
origin,
&format,
&blackBrush);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |