GetTextMetricsW 関数 (wingdi.h)

[アーティクル]
03/04/2024

GetTextMetrics 関数は、指定したバッファーに、現在選択されているフォントのメトリックを入力します。

構文

BOOL GetTextMetricsW(
  [in]  HDC           hdc,
  [out] LPTEXTMETRICW lptm
);

パラメーター

[in] hdc

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

[out] lptm

テキストメトリックを受け取る TEXTMETRIC 構造体へのポインター。

戻り値

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

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

注釈

フォントが TrueType フォントかどうかを判断するには、まずそのフォントを DC に選択してから GetTextMetrics を呼び出し、TEXTMETRIC.tmPitchAndFamily でTMPF_TRUETYPEをチェックします。 GetDC は、既定のフォントとして "System" (ビットマップフォント) を持つ初期化されていない DC を返します。したがって、DC にフォントを選択する必要があります。

例

例については、「キーボード入力を使用する」または「同じ行に異なるフォントからテキストを描画する」の「キーボード入力を表示する」を参照してください。

注意

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

要件

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