PolyTextOutA 函式 (wingdi.h)
PolyTextOut 函式會使用目前在指定裝置內容中選取的字型和文字色彩來繪製數個字串。
語法
BOOL PolyTextOutA(
[in] HDC hdc,
[in] const POLYTEXTA *ppt,
[in] int nstrings
);
參數
[in] hdc
裝置內容的句柄。
[in] ppt
描述要繪製之字串之 POLYTEXT 陣列的指標 結構。 數位包含要繪製之每個字串的一個結構。
[in] nstrings
pptxt 陣列中 POLYTEXT 結構的數目。
傳回值
如果函式成功,則傳回值為非零值。
如果函式失敗,傳回值為零。
言論
每個 POLYTEXT 結構都包含 Windows 用來對齊對應文字字串的參考點座標。 應用程式可以藉由呼叫 SetTextAlign 函式來指定參考點的使用方式。 應用程式可以呼叫 getTextAlign 函式,以判斷指定裝置內容的目前文字對齊設定。
若要繪製單一文字字串,應用程式應該呼叫 ExtTextOut 函式。
PolyTextOut 不會自動處理國際腳本支援。 若要取得國際腳本支援,請改用 ExtTextOut。 ExtTextOut 會在必要時使用 Uniscribe,進而產生字型後援。 此外,ExtTextOut 會在轉換至核心模式之前執行內部批次呼叫,在權衡使用 PolyTextOut 與 ExtTextOut時,降低某些效能考慮。
提示
ExtTextOut 強烈建議 PolyTextOut,因為它能夠處理不同語言的顯示。
注意
wingdi.h 標頭會將 PolyTextOut 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | wingdi.h (包括 Windows.h) |
連結庫 | Gdi32.lib |
DLL | Gdi32.dll |