ScriptSubstituteSingleGlyph 函式 (usp10.h)
啟用以相同字元的一種替代形式取代單一圖像,以進行OpenType處理。
語法
HRESULT ScriptSubstituteSingleGlyph(
[in, optional] HDC hdc,
[in, out] SCRIPT_CACHE *psc,
[in, optional] SCRIPT_ANALYSIS *psa,
[in] OPENTYPE_TAG tagScript,
[in] OPENTYPE_TAG tagLangSys,
[in] OPENTYPE_TAG tagFeature,
[in] LONG lParameter,
[in] WORD wGlyphId,
[out] WORD *pwOutGlyphId
);
參數
[in, optional] hdc
裝置內容的句柄。 如需詳細資訊,請參閱 快取。
[in, out] psc
指出腳本快 取之SCRIPT_CACHE 結構的指標。
[in, optional] psa
從先前呼叫 ScriptItemizeOpenType 取得之SCRIPT_ANALYSIS結構的指標。 此參數會識別成形引擎,以便使用正確的替代字元。
或者,應用程式可以將此參數設定為 NULL ,以擷取未篩選的結果。
[in] tagScript
定義文本標記以進行成形 的OPENTYPE_TAG 結構。
[in] tagLangSys
定義用於成形之語言標籤 的OPENTYPE_TAG 結構。
[in] tagFeature
OPENTYPE_TAG結構,定義用來成形替代字元的功能標記。
[in] lParameter
要取代之替代字元的參考。 此參考是陣列的索引,其中包含功能中定義的所有替代字元,如 OPENTYPE_FEATURE_RECORD所述。 替代字元陣列是 ScriptGetFontAlternateGlyphs 所擷取的其中一個專案。
[in] wGlyphId
原始字元的識別碼。
[out] pwOutGlyphId
這個函式擷取替代字元標識碼的位置指標。
傳回值
若成功,即傳回 0。 如果函式未成功,函式會傳回非零 HRESULT 值。 應用程式可以使用 SUCCEEDED 和 FAILED 宏來測試傳回值。
備註
此函式會使用一對一替代,其中應用程式可以使用一個替代形式來替代一個字元。 通常,應用程式會使用此函式,在線條的開頭或結尾設定項目符號或替代字元。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | usp10.h |
程式庫 | Usp10.lib |
Dll | Usp10.dll |
可轉散發套件 | 在 Windows XP 上 Usp10.dll 1.600 版或更新版本 |