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

[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

另请参阅

DriverStringOptions

字体

显卡

Graphics::D rawDriverString

矩阵

RectF

SolidBrush