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

發行項
01/10/2024

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 終止，長度參數可以設定為 –1。

[in] font

類型： const 字型*

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

[in, ref] layoutRectSize

類型： const SizeF

SizeF 對象的參考，指定系結字串之矩形的寬度和高度。

[in] stringFormat

類型： const StringFormat*

StringFormat 物件的指標，指定版面配置資訊，例如對齊、修剪、製表位等等。

[out] size

類型： SizeF*

SizeF 物件的指標，該物件會接收系結字串之矩形的寬度和高度。

[out] codepointsFitted

類型： INT*

選擇性。 INT 的指標，接收實際符合版面配置矩形的字元數。預設值為 NULL 指標。

[out] linesFilled

類型： INT*

選擇性。 INT 的指標，接收實際符合版面配置矩形的行數。預設值為 NULL 指標。

傳回值

類型：狀態

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

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

規格需求


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