Graphics：：MeasureDriverString 方法 (gdiplusgraphics.h)

项目
02/26/2024

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