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	以十六進位值標示不支援的字元，0xffff。

如果函式成功，它會傳回 ANSI 函式) 或 WORD 的位元組數 (， (Unicode 函式) 轉換。

如果函式失敗，傳回值會GDI_ERROR。

此函式會嘗試識別 lpstr所指向字串中每個字元的單一字元表示。雖然這適用于某些低階用途 (，例如操作字型檔案) ，但想要將字串對應至字元的高階應用程式通常會想要使用 Uniscribe 函式。

注意

wingdi.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetGlyphIndices 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。