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 使用方式時的一些效能考慮。

提示

強烈建議使用PolyTextOut進行新式開發，因為其能夠處理不同語言的顯示。

注意

wingdi.h 標頭會將 PolyTextOut 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll

另請參閱

ExtTextOut

字型和文字函式

字型和文字概觀

GetTextAlign

POLYTEXT

SetTextAlign