共用方式為

iTfReverseConversionMgr：：GetReverseConversion 方法 (msctf.h)

  • 發行項

[GetReverseConversion 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 僅供內部使用。]

擷取可執行反向轉換的 ITfReverseConversion 物件。

語法

HRESULT GetReverseConversion(
  [in]  LANGID               langid,
  [in]  REFGUID              guidProfile,
  [in]  DWORD                dwflag,
  [out] ITfReverseConversion **ppReverseConversion
);

參數

[in] langid

目標字串所屬配置檔的語言標識碼。

[in] guidProfile

目標字串所屬配置檔的 GUID。

[in] dwflag

值 意義
TF_RCM_COMLESS
0x00000001
 在沒有 COM 的情況下啟動反向轉換介面。
TF_RCM_VKEY
0x00000002
 輸出應該是虛擬金鑰碼的陣列， (而非字元金鑰碼) 。
TF_RCM_HINT_READING_LENGTH
0x00000004
 反向轉換應該根據輸入序列的長度，優先排列輸出清單中的項目順序，並先設定最短序列的順序。 具有低衝突計數的輸入序列可能遠高於具有類似 (但衝突計數稍微) 較高的輸入序列。 此旗標的解譯會因輸入法而異。
TF_RCM_HINT_COLLISION
0x00000008
 反向轉換應該根據衝突計數來排定輸出清單中的項目順序，其中的專案會先包含最少的衝突數目。 如果輸入序列對應到比稍長輸入序列還多的字元，最好改用較長的輸入序列。 IME 會判斷此旗標是否會影響反向轉換輸出。

[out] ppReverseConversion

可執行指定反向轉換之 ITfReverseConversion 對象的位址指標。

傳回值

這個方法可以傳回下列其中一個值。

傳回值 描述
S_OK
 指定的 langid 和 guidProfile 組合可以使用 ITfReverseConversion。
E_NOTIMPL
 指定的 langid 和 guidProfile 組合不支援反向轉換。
E_FAIL
 發生未指定的錯誤。

備註

反向轉換提供建立指定字串所需的按鍵序列。

當 dwflag 未指定TF_RCM_HINT_COLLISION或TF_RCM_HINT_READING_LENGTH旗標時，IME 可能不會依任何順序排列輸出。

規格需求

需求 值
最低支援的用戶端 具有 SP2 的 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 SP1 [僅限桌面應用程式]
目標平台 Windows
標頭 msctf.h
Dll Msctf.dll

另請參閱

ITfReverseConversionMgr