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

Graphics：：MeasureString 方法會測量指定字型和版面配置矩形中字串的範圍。

語法

Status MeasureString(
  [in]      const WCHAR    *string,
  [in]      INT            length,
  [in]      const Font     *font,
  [in, ref] const PointF & origin,
  [out]     RectF          *boundingBox
);

參數

[in] string

類型： const WCHAR*

要測量之寬字元字串的指標。

重要 對於阿拉伯文等雙向語言，字串長度不能超過 2046 個字元。

 

[in] length

類型： INT

指定 字串 陣列中字元數的整數。 如果字串為 Null 終止， 長度 參數可以設定為 –1。

[in] font

類型： const 字型*

Font 物件的指標，指定套用至字串之字型的系列名稱、大小和樣式。

[in, ref] origin

類型： const PointF

字串開始之點的參考。

[out] boundingBox

類型： RectF*

RectF 物件的指標，該物件會接收系結字串的矩形。

傳回值

類型： 狀態

如果方法成功，它會傳回OK，這是 Status 列舉的元素。

如果方法失敗，它會傳回 Status 列舉的其中一個其他元素。

規格需求

最低支援的用戶端	Windows XP、Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	gdiplusgraphics.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll

另請參閱

DrawString 方法

字型

圖形

RectF