ScriptGetFontFeatureTags 函式 (usp10.h)

發行項
03/13/2024

擷取 OpenType 處理所定義寫入系統的印刷樣式功能清單。組成清單的印刷樣式功能標籤會從提供的裝置內容或快取中的字型擷取。

語法

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

參數

[in, optional] hdc

裝置內容的句柄。如需詳細資訊，請參閱快取。

[in, out] psc

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

[in, optional] psa

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

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

[in] tagScript

OPENTYPE_TAG結構，定義與指定特徵標籤相關聯的腳本標記。

[in] tagLangSys

OPENTYPE_TAG結構，定義與指定特徵標籤相關聯的語言標記。

[in] cMaxTags

pFeatureTags 所指定的陣列長度。

[out] pFeatureTags

緩衝區的指標，此函式會擷取 OPENTYPE_TAG 結構的數位，此陣列定義所定義寫入系統之裝置內容或快取中字型所支援的印刷樣式功能標記。

[out] pcTags

功能標記陣列中元素數目的指標。

傳回值

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

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

備註

正式宣告為 ULONG 類型時， OPENTYPE_TAG 結構包含四個 8 位 ASCII 空間、A-Z 或 a-z 值的 4 位元組陣列。例如，Ligature 功能的功能標籤是 “liga”。

此函式會隱藏腳本必要或語言必要功能，因為成形引擎會控制這些功能。應用程式無法控制語言所需功能的成形引擎處理。例如， ScriptGetFontFeatureTags 會隱藏初始、medial 和最終窗體的阿拉伯文腳本功能。

重要從 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 版或更新版本