Graphics：：MeasureDriverString 方法 (gdiplusgraphics.h)

發行項
02/29/2024

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*

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

[in] positions

類型： const PointF*

如果設定 DriverStringOptionsRealizedAdvance 旗標， positions 是 PointF 物件的指標，指定第一個圖像的位置。否則，位置是 PointF 物件的陣列，每個物件都會指定個別圖像的原點。

[in] flags

類型： INT

整數，指定字串外觀的選項。這個值必須是 DriverStringOptions 列舉的元素，或是套用至其中兩個或多個元素的位 OR 結果。

[in] matrix

類型： const 矩陣*

Matrix 物件的指標，指定要套用至文字陣列中每個值的轉換矩陣。

[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