共用方式為

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。

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

言論

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

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wingdi.h （包括 Windows.h）
連結庫 Gdi32.lib
DLL Gdi32.dll

另請參閱

字型和文字函式

字型和文字概觀

GetFontUnicodeRanges