Graphics：：MeasureString (constWCHAR*，INT，constFont*，constSizeF&，constStringFormat*，SizeF*，INT*，INT*) 方法 (gdiplusgraphics.h)

  • 项目

Graphics：：MeasureString 方法测量指定字体、格式和布局矩形中字符串的范围。

语法

Status MeasureString(
  [in]      const WCHAR        *string,
  [in]      INT                length,
  [in]      const Font         *font,
  [in, ref] const SizeF &      layoutRectSize,
  [in]      const StringFormat *stringFormat,
  [out]     SizeF              *size,
  [out]     INT                *codepointsFitted,
  [out]     INT                *linesFilled
);

参数

[in] string

类型： const WCHAR*

指向要度量的宽字符字符串的指针。

重要 对于双向语言（如阿拉伯语），字符串长度不得超过 2046 个字符。
 

[in] length

类型： INT

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

[in] font

类型： const Font*

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

[in, ref] layoutRectSize

类型： const SizeF

对 SizeF 对象的引用，该对象指定绑定字符串的矩形的宽度和高度。

[in] stringFormat

类型： const StringFormat*

指向 StringFormat 对象的指针，该对象指定布局信息，例如对齐、剪裁、制表位等。

[out] size

类型： SizeF*

指向 SizeF 对象的指针，该对象接收绑定字符串的矩形的宽度和高度。

[out] codepointsFitted

类型： INT*

可选。 指向 INT 的指针，该 INT 接收实际适合布局矩形的字符数。 默认值为 NULL 指针。

[out] linesFilled

类型： INT*

可选。 指向 INT 的指针，该 INT 接收实际适合布局矩形的行数。 默认值为 NULL 指针。

返回值

类型： 状态

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

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

要求

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

另请参阅

DrawString 方法

字体

显卡

RectF

StringFormat