通过

Graphics：:D rawString (constWCHAR*，INT，constFont*，constPointF&，constStringFormat*，constBrush*) 方法 (gdiplusgraphics.h)

  • 项目

Graphics：:D rawString 方法基于字体、字符串原点和格式绘制字符串。

语法

Status DrawString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const PointF &     origin,
  [in]      const StringFormat *stringFormat,
  [in]      const Brush        *brush
);

参数

[in] string

类型： const WCHAR*

指向要绘制的宽字符字符串的指针。

[in] length

类型： INT

指定 字符串 数组中的字符数的整数。 如果字符串以 null 结尾，则可以将 length 参数设置为 –1。

[in] font

类型： const 字体*

指向 Font 对象的指针，该对象指定字体属性 (要使用的字体名称、大小和字体) 样式。

[in, ref] origin

类型： const PointF

对指定字符串起点的 PointF 对象的引用。

[in] stringFormat

类型： const StringFormat*

指向 StringFormat 对象的指针，该对象指定要应用于字符串的文本布局信息和显示操作。

[in] brush

类型： const Brush*

指向用于填充字符串的 Brush 对象的指针。

返回值

类型： 状态

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

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

注解

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

使用 GDI+ API 时，不得允许应用程序从不受信任的源下载任意字体。 操作系统需要提升的权限，以确保所有已安装的字体都受信任。

示例

以下示例使用指定的格式在指定的原点绘制字符串。

VOID Example_DrawString3(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a string.
   WCHAR string[] = L"Sample Text";
   
   // Initialize arguments.
   Font myFont(L"Arial", 16);
   PointF origin(0.0f, 0.0f);
   SolidBrush blackBrush(Color(255, 0, 0, 0));
   StringFormat format;
   format.SetAlignment(StringAlignmentCenter);

   // Draw string.
   graphics.DrawString(
   string,
   11,
   &myFont,
   origin,
   &format,
   &blackBrush);
}

要求

要求 值
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 gdiplusgraphics.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

字体

显卡

笔

PointF

StringFormat