PolyTextOutA 関数 (wingdi.h)

[アーティクル]
08/27/2023

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

構文

BOOL PolyTextOutA(
  [in] HDC             hdc,
  [in] const POLYTEXTA *ppt,
  [in] int             nstrings
);

パラメーター

[in] hdc

デバイスコンテキストへのハンドル。

[in] ppt

描画する文字列を記述する POLYTEXT 構造体の配列へのポインター。配列には、描画する文字列ごとに 1 つの構造体が含まれています。

[in] nstrings

pptxt 配列内の POLYTEXT 構造体の数。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

注釈

各 POLYTEXT 構造体には、Windows が対応するテキスト文字列の配置に使用する参照ポイントの座標が含まれています。アプリケーションでは、 SetTextAlign 関数を呼び出すことによって、参照ポイントの使用方法を指定できます。アプリケーションは、 GetTextAlign 関数を呼び出すことによって、指定されたデバイスコンテキストの現在のテキスト配置設定を決定できます。

テキストの 1 つの文字列を描画するには、アプリケーションで ExtTextOut 関数を呼び出す必要があります。

PolyTextOut では、国際スクリプトのサポートは自動的に処理されません。国際スクリプトのサポートを取得するには、代わりに ExtTextOut を使用します。 ExtTextOut では、必要に応じて Uniscribe が使用され、フォントフォールバックが発生します。さらに、ExtTextOut はカーネルモードに移行する前に呼び出しの内部バッチ処理を実行し、PolyTextOut と ExtTextOut の使用量を比較する際のパフォーマンス上の問題の一部を軽減します。

ヒント

ExtTextOut は、さまざまな言語の表示を処理する機能により、最新の開発のために PolyTextOut よりも強く推奨されます。

注意

wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PolyTextOut を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll