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

项目
02/22/2024

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 对象的指针，该对象指定第一个字形的位置。否则， positions 是 PointF 对象的数组，每个对象指定单个字形的原点。

[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