GetCharWidth32W 関数 (wingdi.h)

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

構文

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

パラメーター

[in] hdc

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

[in] iFirst

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

[in] iLast

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

[out] lpBuffer

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

戻り値

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

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

解説

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

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

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

例

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

注意

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

要件

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

関連項目

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

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

GetCharABCWidths

GetCharABCWidthsFloat

GetCharWidthFloat