Graphics::D rawDriverString 方法 (gdiplusgraphics.h)

Graphics::D rawDriverString 方法在指定位置绘制字符。 方法使客户端可以完全控制文本的外观。 方法假定客户端已设置要应用的格式和布局。

语法

Status DrawDriverString(
  [in] const UINT16 *text,
  [in] INT          length,
  [in] const Font   *font,
  [in] const Brush  *brush,
  [in] const PointF *positions,
  [in] INT          flags,
  [in] const Matrix *matrix
);

参数

[in] text

类型: const UINT16*

指向 16 位值的数组的指针。 如果设置了 DriverStringOptionsCmapLookup 标志,则每个值将指定要显示的 Unicode 字符。 否则,每个值指定字体字形的索引,该字形定义要显示的字符。

[in] length

类型: INT

指定 文本 数组中值数的整数。 如果字符串为 null 终止,则可以将 length 参数设置为 –1。

[in] font

类型: const Font*

指向 Font 对象的指针,该对象指定要应用于字符串的字体的系列名称、大小和样式。

[in] brush

类型: const Brush*

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

[in] positions

类型: const PointF*

如果设置了 DriverStringOptionsRealizedAdvance 标志, 则 positions 是指向 PointF 对象的指针,该对象指定第一个字形的位置。 否则, positionsPointF 对象的数组,每个对象指定单个字形的原点。

[in] flags

类型: INT

指定字符串外观选项的整数。 此值必须是 DriverStringOptions 枚举的元素,或者是应用于其中两个或多个元素的按位 OR 的结果。

[in] matrix

类型: const Matrix*

指向 Matrix 对象的指针,该对象指定要应用于 文本 数组中的每个值的转换矩阵。

返回值

类型: 状态

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

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

注解

此方法不支持处理复杂脚本,并假定客户端已以其他某种方式设置所有文本布局。 此方法可用于创建所有者绘制的菜单项。 客户端应将 DrawString 方法 用于常规用途。

要求

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

另请参阅

Brush

DrawString 方法

DriverStringOptions

字体

显卡

Graphics::MeasureDriverString

矩阵

PointF