Graphics::MeasureDriverString 方法 (gdiplusgraphics.h)
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 |