次の方法で共有

PolyTextOutA 関数 (wingdi.h)

  • [アーティクル]

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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wingdi.h (Windows.h を含む)
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目

ExtTextOut を する

フォント関数とテキスト関数

フォントとテキストの概要

GetTextAlign の

POLYTEXT

SetTextAlign の