PolyTextOutW

PolyTextOut 関数は、指定したデバイスコンテキストに現在選択されているフォントとテキスト色を使用して、複数の文字列を描画する。(Unicode)

PolyTextOutW hdc, ppt, nstrings

hdc : [intptr] デバイスコンテキストへのハンドル。
ppt : [var] 描画する文字列を記述する POLYTEXT 構造体の配列へのポインタ。配列には描画する各文字列ごとに 1 つの構造体が含まれる。
nstrings : [int] pptxt 配列内の POLYTEXT 構造体の数。

(プラグイン / モジュール : gdi32.dll)

解説

PolyTextOut
関数は、指定したデバイスコンテキストに現在選択されているフォントとテキスト色を使用して、複数の文字列を描画する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は非ゼロである。関数が失敗した場合、戻り値はゼロである。

[備考]
各 POLYTEXT 構造体には、Windows が対応する文字列を揃えるために使用する参照点の座標が含まれる。アプリケーションは
SetTextAlign 関数を呼び出すことで、参照点の使い方を指定できる。アプリケーションは GetTextAlign
関数を呼び出すことで、指定したデバイスコンテキストの現在のテキスト配置設定を取得できる。単一のテキスト文字列を描画するには、アプリケーションは
ExtTextOut 関数を呼び出すべきである。**PolyTextOut**
は国際スクリプトサポートを自動的には処理しない。国際スクリプトサポートを得るには、代わりに **ExtTextOut**
を使用する。**ExtTextOut** は必要に応じて
[Uniscribe](/windows/win32/intl/uniscribe)
を使用し、フォントフォールバックを行う。さらに、**ExtTextOut**
はカーネルモードに遷移する前に呼び出しを内部的にバッチ処理するため、**PolyTextOut** と **ExtTextOut**
のパフォーマンスを比較する際の懸念の一部を軽減する。> [!TIP] > 異なる言語の表示を扱えるため、現代的な開発では
**PolyTextOut** より **ExtTextOut** の使用を強く推奨する。> [!NOTE] > wingdi.h
ヘッダーは PolyTextOut を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode
版を自動的に選択するエイリアスとして定義している。エンコーディング中立なエイリアスをエンコーディング中立でないコードと混在させると、コンパイルエラーや実行時エラーを引き起こす不一致が発生することがある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報