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 |