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

  • 项目

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

语法

Status MeasureString(
  const WCHAR        *string,
  INT                length,
  const Font         *font,
  const RectF &      layoutRect,
  const StringFormat *stringFormat,
  RectF              *boundingBox,
  INT                *codepointsFitted,
  INT                *linesFilled
);

参数

string

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

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

length

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

font

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

layoutRect

对绑定字符串的矩形的引用。

stringFormat

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

boundingBox

指向 RectF 对象的指针，该对象接收绑定字符串的矩形。

codepointsFitted

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

linesFilled

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

返回值

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

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

注解

示例

以下示例测量字符串的大小，然后绘制一个表示该大小的矩形。

VOID Example_MeasureString2(HDC hdc)
{
   Graphics graphics(hdc);
   // Set up the string.
   WCHAR string[] = L"Measure Text";
   Font font(L"Arial", 16);
   RectF layoutRect(0.0f, 0.0f, 100.0f, 50.0f);
   StringFormat format;
   format.SetAlignment(StringAlignmentFar);
   RectF boundRect;
   // Measure the string.
   graphics.MeasureString(string, 12, &font, layoutRect, &format, &boundRect);
   // Draw a rectangle that represents the size of the string.
   graphics.DrawRectangle(&Pen(Color(255, 0, 0, 0)), boundRect);
}

要求

   
标头 gdiplusgraphics.h

另请参阅

DrawString 方法

字体

显卡

RectF

StringFormat