Graphics::MeasureDriverString 方法 (gdiplusgraphics.h)
Graphics::MeasureDriverString 方法测量指定字符及其相应位置的边界框。
语法
Status MeasureDriverString(
[in] const UINT16 *text,
[in] INT length,
[in] const Font *font,
[in] const PointF *positions,
[in] INT flags,
[in] const Matrix *matrix,
[out] RectF *boundingBox
);
参数
[in] text
类型: const UINT16*
指向 16 位值数组的指针。 如果设置了 DriverStringOptionsCmapLookup 标志,则每个值将指定要显示的 Unicode 字符。 否则,每个值都指定字体字形的索引,该字形定义要显示的字符。
[in] length
类型: INT
指定 文本 数组中的值数的整数。 如果字符串以 null 结尾,则可以将 length 参数设置为 –1。
[in] font
类型: const 字体*
指向 Font 对象的指针,该对象指定要应用于字符串的字体的系列名称、大小和样式。
[in] positions
类型: const PointF*
如果设置了 DriverStringOptionsRealizedAdvance 标志, 则 positions 是指向 PointF 对象的指针,该对象指定第一个字形的位置。 否则, positions 是 PointF 对象的数组,每个对象指定单个字形的原点。
[in] flags
类型: INT
指定字符串外观选项的整数。 此值必须是 DriverStringOptions 枚举的元素,或者是应用于其中两个或更多元素的按位 OR 的结果。
[in] matrix
类型: const Matrix*
指向 Matrix 对象的指针,该对象指定要应用于 文本 数组中的每个值的转换矩阵。
[out] boundingBox
类型: RectF*
指向 RectF 对象的指针,该对象接收绑定字符串的矩形。
返回值
类型: 状态
如果该方法成功,则返回 Ok,这是 Status 枚举的元素。
如果方法失败,它将返回 Status 枚举的其他元素之一。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP、Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | gdiplusgraphics.h (包括 Gdiplus.h) |
Library | Gdiplus.lib |
DLL | Gdiplus.dll |