GraphicsPath：：AddString (constWCHAR，INT，constFontFamily，INT，REAL，constRect&，constStringFormat*) 方法 (gdipluspath.h)

项目
02/27/2024

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