Graphics：:D rawDriverString 方法 (gdiplusgraphics.h)

發行項
02/26/2024

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