次の方法で共有


GetTextFaceA 関数 (wingdi.h)

GetTextFace 関数は、指定したデバイス コンテキストで選択されているフォントの書体名を取得します。

構文

int GetTextFaceA(
  [in]  HDC   hdc,
  [in]  int   c,
  [out] LPSTR lpName
);

パラメーター

[in] hdc

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

[in] c

lpFaceName指すバッファーの長さ。 ANSI 関数の場合は BYTE カウントであり、Unicode 関数の場合は WORD カウントです。 ANSI 関数の場合、SBCS コード ページの文字はそれぞれ 1 バイトですが、DBCS コード ページのほとんどの文字は 2 バイトを取ります。Unicode 関数の場合、現在定義されているほとんどの Unicode 文字 (Basic 多言語プレーン (BMP) の文字) は 1 WORD で、Unicode サロゲートは 2 つの WORD です。

[out] lpName

書体名を受け取るバッファーへのポインター。 このパラメーターが NULL場合、関数は名前の文字数 (終端の null 文字を含む) を返します。

戻り値

関数が成功した場合、戻り値はバッファーにコピーされた文字数です。

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

備考

書体名は、null で終わる文字列としてコピーされます。

名前が nCount パラメーターで指定された文字数より長い場合、名前は切り捨てられます。

手記

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

必要条件

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

関連項目

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

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

GetTextAlign の

GetTextColor を する

GetTextExtentPoint32 の

GetTextMetrics を する