SetTextCharacterExtra 関数 (wingdi.h)

SetTextCharacterExtra 関数は、文字間の間隔を設定します。文字間の間隔は、システムがテキスト行を書き込むときに、区切り文字を含む各文字に追加されます。

構文

int SetTextCharacterExtra(
  [in] HDC hdc,
  [in] int extra
);

[in] hdc

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

[in] extra

各文字に追加する余分なスペース (論理単位)。現在のマッピングモードがMM_TEXTされていない場合は、 nCharExtra パラメーターが変換され、最も近いピクセルに丸められます。

関数が成功した場合、戻り値は前の文字間の間隔です。

関数が失敗した場合、戻り値は0x80000000。

この関数は、主に既存のアプリケーションとの互換性のためにサポートされています。新しいアプリケーションでは、複雑なスクリプト (テキストの整形を必要とするスクリプト) と互換性がないため、通常、この関数の呼び出しを避ける必要があります。アラビア語のスクリプトは、この例です)。

推奨される方法は、この関数を呼び出してから TextOut を呼び出す代わりに、アプリケーションで ExtTextOut を呼び出し、 lpDx パラメーターを使用して幅を指定することです。

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