共用方式為


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 值。 應用程式可以使用 SUCCEEDEDFAILED 宏來測試傳回值。

備註

此函式會使用一對一替代,其中應用程式可以使用一個替代形式來替代一個字元。 通常,應用程式會使用此函式,在線條的開頭或結尾設定項目符號或替代字元。

重要從 Windows 8 開始:若要維護在 Windows 7 上執行的能力,使用 Uniscribe 的模組必須在其連結庫清單中指定 gdi32.lib 之前指定 Usp10.lib。
 

規格需求

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

另請參閱

Caching

OPENTYPE_TAG

SCRIPT_ANALYSIS

SCRIPT_CACHE

ScriptGetFontAlternateGlyphs

ScriptItemizeOpenType

Uniscribe

Uniscribe 函式