Graphics::D rawDriverString 方法 (gdiplusgraphics.h)
Graphics::D rawDriverString 方法會在指定的位置繪製字元。 方法可讓用戶端完全控制文字的外觀。 方法假設客戶端已經設定要套用的格式和版面配置。
語法
Status DrawDriverString(
[in] const UINT16 *text,
[in] INT length,
[in] const Font *font,
[in] const Brush *brush,
[in] const PointF *positions,
[in] INT flags,
[in] const Matrix *matrix
);
參數
[in] text
類型: const UINT16*
16 位值的陣列指標。 如果已設定 DriverStringOptionsCmapLookup 旗標,則每個值都會指定要顯示的 Unicode 字元。 否則,每個值都會指定字型圖像的索引,以定義要顯示的字元。
[in] length
類型: INT
整數,指定 文字 陣列中的值數目。 如果字串為 Null 終止, 長度 參數可以設定為 –1。
[in] font
類型: const 字型*
Font 物件的指標,指定要套用至字串之字型的系列名稱、大小和樣式。
[in] brush
類型: const Brush*
用於填滿字串之 Brush 物件的指標。
[in] positions
類型: const PointF*
如果已設定 DriverStringOptionsRealizedAdvance 旗標, positions 是 PointF 物件的指標,指定第一個圖像的位置。 否則, positions 是 PointF 物件的陣列,每個物件都會指定個別字元的原點。
[in] flags
類型: INT
整數,指定字串外觀的選項。 這個值必須是 DriverStringOptions 列舉的元素,或是套用至其中兩個或多個元素的位 OR 結果。
[in] matrix
類型: const 矩陣*
Matrix 物件的指標,指定要套用至文字陣列中每個值的轉換矩陣。
傳回值
類型: 狀態
如果方法成功,它會傳回 Ok,這是 Status 列舉的元素。
如果方法失敗,它會傳回 Status 列舉的其中一個其他元素。
備註
此方法不支援處理複雜的腳本,並假設用戶端已以其他方式設定所有文字配置。 這個方法適用於建立擁有者繪製的功能表項。 客戶端應該使用 DrawString 方法 進行一般用途。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP、Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | gdiplusgraphics.h (包含 Gdiplus.h) |
程式庫 | Gdiplus.lib |
Dll | Gdiplus.dll |