GetTextFaceW

GetTextFace 関数は、指定したデバイスコンテキストに選択されている HFONT の書体名を取得する。(Unicode)

GetTextFaceW hdc, c, lpName

hdc : [intptr] デバイスコンテキストのハンドル。
c : [int] lpFaceName が指すバッファの長さ。ANSI 関数では BYTE 数、Unicode 関数では WORD 数である。ANSI 関数では SBCS コードページ内の文字は 1 バイト、DBCS コードページ内のほとんどの文字は 2 バイトである。Unicode 関数では、現在定義されているほとんどの Unicode 文字(BMP 内)は 1 WORD、Unicode サロゲートは 2 WORD である点に注意。
lpName : [wstr] 書体名を受け取るバッファへのポインタ。このパラメータが NULL の場合、関数は終端 NULL 文字を含む名前の文字数を返す。

(プラグイン / モジュール : gdi32.dll)

解説

GetTextFace 関数は、指定したデバイスコンテキストに選択されている HFONT の書体名を取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値はバッファへコピーされた文字数である。失敗した場合は 0 である。

[備考]
書体名は NULL 終端文字列としてコピーされる。名前が nCount パラメータで指定された文字数より長い場合、名前は切り詰められる。
> [!NOTE] > wingdi.h ヘッダは GetTextFace をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の有無に応じてこの関数の ANSI 版または Unicode
版が自動的に選択される。エンコーディング中立なエイリアスと非中立コードを混在させると、コンパイルまたは実行時エラーの原因となる不整合を引き起こすことがある。詳細は
[関数プロトタイプの規則](/windows/win32/intl/conventions-for-function-prototypes)
を参照。

情報