GetCharWidth32A 関数 (wingdi.h)

GetCharWidth32 関数は、現在のフォントから指定した範囲内の連続する文字の幅を論理座標で取得します。

構文

BOOL GetCharWidth32A(
  [in]  HDC   hdc,
  [in]  UINT  iFirst,
  [in]  UINT  iLast,
  [out] LPINT lpBuffer
);

パラメーター

[in] hdc

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

[in] iFirst

連続する文字のグループ内の最初の文字。

[in] iLast

連続する文字のグループ内の最後の文字。指定した最初の文字の前に置く必要はありません。

[out] lpBuffer

文字幅を論理座標で受け取るバッファーへのポインター。

戻り値

関数が成功した場合、戻り値は 0 以外です。

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

備考

GetCharWidth32 は TrueType フォントでは使用できません。 TrueType フォントの文字幅を取得するには、GetCharABCWidths使用します。

範囲は包括的です。つまり、返される幅には、iFirstChar および iLastChar パラメーター 指定された文字の幅が含まれます。

現在のフォントに文字が存在しない場合は、既定の文字の幅が割り当てられます。

例

例については、「キーボード入力を使用した のキーボード入力の表示」を参照してください。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	wingdi.h (Windows.h を含む)
ライブラリ	Gdi32.lib
DLL	Gdi32.dll

関連項目

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

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

GetCharABCWidths の

GetCharABCWidthsFloat の

GetCharWidthFloat の