GraphicsPath::AddString(constWCHAR*,INT,constFontFamily*,INT,REAL,constRectF&,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 RectF & layoutRect,
[in] const StringFormat *format
);
Parameter
[in] string
Typ: const WCHAR*
Zeiger auf eine Breitzeichenzeichenfolge.
[in] length
Typ: INT
Eine ganze Zahl, die die Anzahl der anzuzeigenden Zeichen angibt. Wenn der Zeichenfolgenparameter auf eine MIT NULL beendete Zeichenfolge zeigt, kann dieser Parameter auf –1 festgelegt werden.
[in] family
Typ: const FontFamily*
Zeiger auf ein FontFamily-Objekt , das die Schriftartfamilie für die Zeichenfolge angibt.
[in] style
Typ: INT
Ganze Zahl, die den Stil der Schriftart angibt. Dieser Wert muss ein Element der FontStyle-Enumeration oder das Ergebnis eines bitweisen OR sein, das auf mindestens zwei 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 Größe der Zeichenfolgenzeichen in Welteinheiten angibt.
[in, ref] layoutRect
Typ: const RectF
Verweis auf ein RectF-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ürzung, 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, 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.
Beispiele
Im folgenden Beispiel wird ein GraphicsPath-Objektpfad erstellt, dem Pfad eine NULL-endende Zeichenfolge hinzugefügt und dann der Pfad zeichnet. zeichnet.
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,
RectF(50.0f, 50.0f, 150.0f, 100.0f),
NULL);
Pen pen(Color(255, 255, 0, 0));
graphics.DrawPath(&pen, &path);
}
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 | gdipluspath.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |