次の方法で共有


GetGlyphIndicesA 関数 (wingdi.h)

GetGlyphIndices 関数は、文字列をグリフ インデックスの配列に変換します。 この関数を使用して、フォントにグリフが存在するかどうかを判断できます。

構文

DWORD GetGlyphIndicesA(
  [in]  HDC    hdc,
  [in]  LPCSTR lpstr,
  [in]  int    c,
  [out] LPWORD pgi,
  [in]  DWORD  fl
);

パラメーター

[in] hdc

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

[in] lpstr

変換する文字列へのポインター。

[in] c

lpstr によって指 文字列の 長さと、pgiが指すバッファーのサイズ (WORD 単位) の両方の長さ。

[out] pgi

このバッファーは、次元 c である必要があります。 正常に返されると、文字列内の文字に対応するグリフ インデックスの配列が含まれます。

[in] fl

グリフがサポートされていない場合の処理方法を指定します。 このパラメーターには、次の値を指定できます。

価値 意味
GGI_MARK_NONEXISTING_GLYPHS
サポートされていないグリフを 16 進数の値0xffffマークします。

戻り値

関数が成功すると、変換されたバイト数 (ANSI 関数の場合) または WORD (Unicode 関数の場合) が返されます。

関数が失敗した場合、戻り値はGDI_ERROR。

備考

この関数は、lpstrによって指される文字列内の各文字の単一グリフ表現 識別しようとします。 これは特定の低レベルの目的 (フォント ファイルの操作など) に役立ちますが、文字列をグリフにマップする上位レベルのアプリケーションでは、通常、Uniscribe 関数を使用する必要があります。

手記

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

必要条件

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

関連項目

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

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

GetFontUnicodeRanges の