ScriptGetFontLanguageTags 函式 (usp10.h)

發行項
08/26/2023

擷取可用於指定專案的語言標記清單，並由 OpenType 處理的指定腳本標籤支援。組成清單的標記會從指定裝置內容或快取中的字型擷取。

語法

HRESULT ScriptGetFontLanguageTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pLangsysTags,
  [out]          int             *pcTags
);

參數

[in, optional] hdc

裝置內容的控制碼。如需詳細資訊，請參閱快取。

[in, out] psc

識別腳本快取之SCRIPT_CACHE 結構的指標。

[in, optional] psa

從先前呼叫ScriptItemizeOpenType取得之SCRIPT_ANALYSIS結構的指標。此參數會識別成形引擎，以便擷取適當字型和腳本的字型語言標記。

或者，應用程式可以將此參數設定為 Null ，以擷取未篩選的結果。

[in] tagScript

定義要求相關聯語言標籤清單之腳本標記的OPENTYPE_TAG 結構。

[in] cMaxTags

pLangSysTags所指定的陣列長度。

[out] pLangsysTags

緩衝區的指標，此函式會擷取 OPENTYPE_TAG 結構的陣列，以識別符合輸入準則的語言標記。

[out] pcTags

語言標記陣列中元素數目的指標。

傳回值

若成功，即傳回 0。如果函式不成功，函式會傳回非零 HRESULT 值。應用程式可以使用 SUCCEEDED 和 FAILED 宏來測試傳回值。

如果相符標記的數目超過 cMaxTags，則函式會失敗並E_OUTOFMEMORY。應用程式可以嘗試使用較大的緩衝區再次呼叫。

備註

正式宣告為 ULONG 類型時， OPENTYPE_TAG 結構包含四個 8 位 ASCII 空間、A-Z 或 a-z 值的 4 位元組陣列。例如，羅馬尼亞文、Urdu 和匈牙利文的語言標籤分別是「ROM」、「URD」和「FAR」。請注意，每個標記的結尾都是空格。

重要從 Windows 8 開始：若要維持在 Windows 7 上執行的能力，使用 Uniscribe 的模組必須指定 Usp10.lib，才能在其程式庫清單中指定 gdi32.lib。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	usp10.h
程式庫	Usp10.lib
Dll	Usp10.dll
可轉散發套件	在 Windows XP 上 Usp10.dll 1.600 版或更新版本