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
グリフがサポートされていない場合の処理方法を指定します。 このパラメーターには、次の値を指定できます。
値 | 説明 |
---|---|
|
サポートされていないグリフを 16 進数の値0xffffマークします。 |
戻り値
関数が成功すると、変換されたバイト数 (ANSI 関数の場合) または WORD (Unicode 関数の場合) が返されます。
関数が失敗した場合、戻り値はGDI_ERROR。
解説
この関数は、 lpstr が指す文字列内の各文字の単一グリフ表現を識別しようとします。 これは特定の低レベルの目的 (フォント ファイルの操作など) に役立ちますが、文字列をグリフにマップする上位レベルのアプリケーションでは、通常 、Uniscribe 関数を使用する必要があります。
注意
wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetGlyphIndices を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wingdi.h (Windows.h を含む) |
Library | Gdi32.lib |
[DLL] | Gdi32.dll |