GraphicsPath::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constRect&,constStringFormat*)-Methode (gdipluspath.h)
Die GraphicsPath::AddString-Methode fügt diesem Pfad die Gliederung einer Zeichenfolge hinzu.
Syntax
Status AddString(
[in] const WCHAR *string,
[in] INT length,
[in] const FontFamily *family,
[in] INT style,
[in] REAL emSize,
[in, ref] const Rect & layoutRect,
[in] const StringFormat *format
);
Parameter
[in] string
Typ: const WCHAR*
Zeiger auf eine Breitzeichenzeichenfolge.
[in] length
Typ: INT
Ganzzahl, die die Anzahl der anzuzeigenden Zeichen angibt. Wenn der Zeichenfolgenparameter auf eine NULL-beendete Zeichenfolge verweist, kann dieser Parameter auf –1 festgelegt werden.
[in] family
Typ: const FontFamily*
Zeiger auf ein FontFamily-Objekt , das die Schriftfamilie für die Zeichenfolge angibt.
[in] style
Typ: INT
Ganzzahl, die den Stil der Schriftart angibt. Dieser Wert muss ein Element der FontStyle-Enumeration oder das Ergebnis eines bitweisen OR sein, das auf zwei oder mehr dieser Elemente angewendet wird. Legt beispielsweise FontStyleBold | FontStyleUnderline | FontStyleStrikeout den Stil als Kombination der drei Stile fest.
[in] emSize
Typ: REAL
Reelle Zahl, die die Em-Größe der Zeichenfolgenzeichen in Welteinheiten angibt.
[in, ref] layoutRect
Typ: const Rect
Verweis auf ein Rect-Objekt , das in Welteinheiten das umgebende Rechteck für die Zeichenfolge angibt.
[in] format
Typ: const StringFormat*
Zeiger auf ein StringFormat-Objekt , das Layoutinformationen (Ausrichtung, Kürzen, Tabstopps usw.) für die Zeichenfolge angibt.
Rückgabewert
Typ: Status
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.
Beispiele
Im folgenden Beispiel wird ein GraphicsPath-Objektpfad erstellt, eine NULL-beendete Zeichenfolge zum Pfad hinzugefügt und dann der Pfad gezogen.
VOID Example_AddString(HDC hdc)
{
Graphics graphics(hdc);
FontFamily fontFamily(L"Times New Roman");
GraphicsPath path;
path.AddString(
L"Hello World",
-1, // NULL-terminated string
&fontFamily,
FontStyleRegular,
48,
Rect(50, 50, 150, 100),
NULL);
Pen pen(Color(255, 255, 0, 0));
graphics.DrawPath(&pen, &path);
}
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 | gdipluspath.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |