GraphicsPath：：AddString（constWCHAR，INT，constFontFamily，INT，REAL，constPointF&，constStringFormat*）方法（gdipluspath.h）

项目
07/16/2024

GraphicsPath：：AddString 方法将字符串的轮廓添加到此路径。

语法

Status AddString(
  const WCHAR        *string,
  INT                length,
  const FontFamily   *family,
  INT                style,
  REAL               emSize,
  const PointF &     origin,
  const StringFormat *format
);

参数

string

指向宽字符字符串的指针。

length

指定要显示的字符数的整数。如果字符串参数指向 NULL终止字符串，则可以将此参数设置为 –1。

family

指向 FontFamily 对象的指针，该对象指定字符串的字体系列。

style

指定字形样式的整数。此值必须是 FontStyle 枚举的元素，或者是应用于其中两个或多个元素的按位或的结果。例如，FontStyleBold | FontStyleUnderline | FontStyleStrikeout 将样式设置为三种样式的组合。

emSize

指定字符串字符的世界单位 em 大小的实数。

origin

引用 PointF 对象，该对象指定字符串的位置（以世界单位为单位）。

format

指向 StringFormat 对象的指针，该对象指定字符串的布局信息（对齐、剪裁、制表位等）。

返回值

类型：状态

如果方法成功，则返回 Ok，这是状态枚举的元素。

如果方法失败，它将返回状态枚举的其他元素之一。

言论

请注意，GDI+ 不支持没有 TrueType 轮廓的 PostScript 字体或 OpenType 字体。

例子

以下示例创建 GraphicsPath 对象路径，向路径添加以 NULL 结尾的字符串，然后绘制路径。

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, 
      PointF(50.0f, 50.0f),
      NULL);

   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}