共用方式為

immNotifyIME 函式 (imm.h)

  • 發行項

通知輸入內容狀態的輸入法變更。

語法

BOOL ImmNotifyIME(
       HIMC  unnamedParam1,
  [in] DWORD dwAction,
  [in] DWORD dwIndex,
  [in] DWORD dwValue
);

參數

unnamedParam1

[in] dwAction

通知碼。 此參數可以有下列其中一個值。

值 意義
NI_CHANGECANDIDATELIST
 應用程式已變更目前選取的候選項目。 dwIndex參數會指定要選取且未使用dwValue的候選清單索引。
NI_CLOSECANDIDATE
 應用程式會指示輸入法關閉候選清單。 dwIndex參數會指定要關閉的清單索引，而且不會使用dwValue。 輸入法會在關閉清單時，將 IMN_CLOSECANDIDATE 命令傳送至應用程式。
NI_COMPOSITIONSTR
 應用程式會指示輸入法在組合字元串上執行動作。 dwIndex參數可以是CPS_CANCEL、CPS_COMPLETE、CPS_CONVERT或CPS_REVERT。
NI_IMEMENUSELECTED
 應用程式會指示輸入法，以允許應用程式處理指定的功能表。 dwIndex參數會指定功能表的識別碼，而 dwValue是該功能表項目的應用程式定義值。
NI_OPENCANDIDATE
 應用程式會指示輸入法開啟候選清單。 dwIndex參數會指定要開啟的清單索引，而且不會使用dwValue。 輸入法會在開啟清單時，將 IMN_OPENCANDIDATE 命令傳送至應用程式。
NI_SELECTCANDIDATESTR
 應用程式已選取其中一個候選項目。 dwIndex參數會指定要選取之候選清單的索引。 dwValue參數會在選取的候選清單中指定候選字串的索引。
NI_SETCANDIDATE_PAGESIZE
 應用程式會變更候選清單的頁面大小。 dwIndex參數會指定要變更的候選清單，而且必須具有範圍 0 到 3 的值。 dwValue參數會指定新的頁面大小。
NI_SETCANDIDATE_PAGESTART
 應用程式會變更候選清單的頁面起始索引。 dwIndex參數會指定要變更的候選清單，而且必須具有範圍 0 到 3 的值。 dwValue參數會指定新的頁面起始索引。

[in] dwIndex

候選清單的索引。 或者，如果 dwAction 是NI_COMPOSITIONSTR，此參數可以有下列其中一個值。

值 意義
CPS_CANCEL
 清除組合字元串，並將狀態設定為沒有組合字元串。
CPS_COMPLETE
 將組合字元串設定為結果字串。
CPS_CONVERT
 轉換組合字元串。
CPS_REVERT
 取消目前的組合字元串，並將組合字元串設定為未轉換的字串。

[in] dwValue

候選字串的索引。 應用程式可以根據 dwAction 參數的值來設定此參數或忽略此參數。

傳回值

如果成功，則傳回非零，否則傳回 0。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]，已安裝東亞語言支援。
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 imm.h (包括 Immdev.h、Windows.h)
程式庫 Imm32.lib
Dll Imm32.dll

另請參閱

IMN_CLOSECANDIDATE

IMN_OPENCANDIDATE

輸入方法管理員

輸入方法管理員函式