GraphicsPath：：AddString (constWCHAR*，INT，constFontFamily*，INT，REAL，constRectF&，constStringFormat*) 方法 (gdipluspath.h)
GraphicsPath：：AddString 方法将字符串的轮廓添加到此路径。
语法
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
);
参数
[in] string
类型： const WCHAR*
指向宽字符字符串的指针。
[in] length
类型： INT
指定要显示的字符数的整数。 如果 字符串 参数指向 以 NULL 结尾的字符串，则可以将此参数设置为 –1。
[in] family
类型： const FontFamily*
指向 FontFamily 对象的指针，该对象指定字符串的字体系列。
[in] style
类型： INT
指定字体样式的整数。 此值必须是 FontStyle 枚举的元素，或者是应用于其中两个或多个元素的按位 OR 的结果。 例如， FontStyleBold | FontStyleUnderline | FontStyleStrikeout 将样式设置为三种样式的组合。
[in] emSize
类型： REAL
实数，指定字符串字符的 em 大小（以世界单位为单位）。
[in, ref] layoutRect
类型： const RectF
对 RectF 对象的引用，该对象以世界单位指定字符串的边框。
[in] format
类型： const StringFormat*
指向 StringFormat 对象的指针，该对象指定布局信息 (对齐方式、剪裁、制表位等字符串) 。
返回值
类型： 状态
如果方法成功，则返回 Ok，这是 Status 枚举的元素。
如果 方法失败，它将返回 Status 枚举的其他元素之一。
注解
请注意，GDI+ 不支持没有 TrueType 轮廓的 PostScript 字体或 OpenType 字体。
示例
以下示例创建 GraphicsPath 对象 路径，将 NULL 结尾的字符串添加到 path，然后绘制 路径。
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);
}
要求
| 最低受支持的客户端 | Windows XP、Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | gdipluspath.h (包括 Gdiplus.h) |
| Library | Gdiplus.lib |
| DLL | Gdiplus.dll |
另请参阅
StringFormat