GraphicsPath::AddString (constWCHAR*,INT,constFontFamily*,INT,REAL,constRect&,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 Rect &       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 Rect

Rect 对象的引用,该对象以世界单位指定字符串的边框。

[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, 
      Rect(50, 50, 150, 100),
      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

另请参阅

AddString 方法

使用区域进行剪裁

构造并绘制轨迹

创建路径渐变

字体

FontFamily

FontStyle

GraphicsPath

Rect

StringFormat

使用文本和字体