共用方式為

IImePad：：Request 方法 (imepad.h)

  • 發行項

由 IImePad Applet呼叫，以將文字插入應用程式。

Request 是唯一 IImePad Applet 可以呼叫的方法。 藉由使用其中一個 IMEPADREQ_* 要求識別碼呼叫這個方法， IImePad Applet 可以將文字插入應用程式中，而且可以在應用程式中控制 IME 的撰寫字串。

語法

HRESULT Request(
  [in]      IImePadApplet *pIImePadApplet,
  [in]      INT           reqId,
  [in, out] WPARAM        wParam,
  [in, out] LPARAM        lParam
);

參數

[in] pIImePadApplet

呼叫小程式的介面指標。

[in] reqId

要求識別碼 (類型) 。 這必須設定為下列其中一個值：

值 意義
IMEPADREQ_INSERTSTRING
 將字串插入應用程式做為組合字元串。
  • wParam：要插入應用程式中的 Null終止字串指標 (LPWSTR) 。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_SENDCONTROL
 控制應用程式中字串和插入號的組成。
  • wParam：指定要求 IME 處理組合字元串和插入號位置的控制項值 (IMEPADCTRL_*) 。 如需 IMEPADCTRL_* 值的清單，請參閱。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_SETAPPLETSIZE
 設定新的小程式視窗大小。
  • wParam： LOWORD (wParam) 指定小程式寬度。 HIWORD (wParam) 指定小程式的高度
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_GETCOMPOSITIONSTRING
 取得目前的組合字元串文字。
  • wParam：指向要接收目前組合字元串文字的緩衝區 (LPWSTR) 。
  • lParam：要複製的最大字元數，包括終止的 Null 字元。
IMEPADREQ_GETCOMPOSITIONSTRINGINFO
 取得目前組合字元串的相關資訊。
IMEPADREQ_DELETESTRING
 刪除組合字元串。
  • wParam：LOWORD (wParam) 指定要刪除之組合字元串的開始位置。 HIWORD (wParam) 指定要刪除的撰寫字串長度。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_CHANGESTRING
 取代組合字元串的一部分。
  • wParam：取代字串的指標 (LPWSTR) 。
  • lParam：LOWORD (lParam) 指定要取代之組合字元串的開始位置。 HIWORD (lParam) 指定要取代之組合字元串的長度。
IMEPADREQ_GETAPPLHWND
 取得應用程式視窗控制碼。
  • wParam： HWND 控制碼位址 (HWND *) 接收應用程式視窗控制碼。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_FORCEIMEPADWINDOWSHOW
 讓 ImePad 視窗保持可見。
  • wParam： TRUE 可讓 IMEPad 視窗保持可見。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_POSTMODALNOTIFY
 讓 IImePad 以特定通知識別碼和使用者定義的資料，以非同步方式呼叫 applet 的 Notify 方法。
  • wParam：通知程式碼 (IMEPN_*) 。 如需可能的IMEPN_*代碼，請參閱IImePad Applet：：Notify的。
  • lParam：使用者定義的資料
IMEPADREQ_GETDEFAULTUILANGID
 取得建議 (預設) ImePad applet UI 語言。
  • wParam：語言識別項 (LANGID 的位址 *) ，以接收預設 UI 語言。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_GETCURRENTUILANG
 取得目前的 ImePad 小程式 UI 語言。
  • wParam：要接收目前 UI 語言的語言識別項 (LANGID *) 位址。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_GETAPPLETUISTYLE
 取得小程式 UI 樣式 (IPAWS_* 旗標) 。
  • wParam：接收小程式 UI 樣式的位址 (DWORD *) 。 樣式是 IPAWS_* 旗標的組合;如需可能的 IPAWS_* 旗標，請參閱。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_SETAPPLETUISTYLE
 設定小程式 UI 樣式 (IPAWS_* 旗標) 。
  • wParam：Applet UI 樣式。 樣式是 IPAWS_* 旗標的組合;如需可能的 IPAWS_* 旗標，請參閱。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_ISAPPLETACTIVE
 判斷小程式是否作用中。
  • wParam：接收 BOOL *) 值 (位址。 如果為 TRUE，則小程式為作用中;否則，小程式不會作用中。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_ISIMEPADWINDOWVISIBLE
 判斷 ImePad 是否可見。
  • wParam：接收 BOOL *) 值 (位址。 如果為 TRUE，則會顯示 ImePad;否則看不到 ImePad。
  • lParam：未使用。 必須設定為 0。
IMEPADREQ_SETAPPLETMINMAXSIZE
 設定小程式大小下限和上限。
  • wParam： loWORD (wParam) 指定小程式寬度。 HIWORD (wParam) 會指定小程式高度。
  • lParam： TRUE 會設定大小上限; FALSE 可設定最小大小。
IMEPADREQ_GETCONVERSIONSTATUS
 取得目前的應用程式輸入法轉換狀態。 如需轉換和句子模式的完整清單，請參閱標頭檔 Imm.h。
  • wParam：接收轉換模式的位址 (DWORD *) 。
  • lParam：接收句子模式的位址 (DWORD *) 。
IMEPADREQ_GETVERSION
 取得 IImePad的版本資訊。
  • wParam：接收主要版本 (DWORD *) 的位址。
  • lParam：接收次要版本 (DWORD *) 的位址。
IMEPADREQ_GETCURRENTIMEINFO
 取得叫用 ImePad 的 IME 資訊。
  • wParam：接收 IME 語言識別項的位址 (DWORD *) 。
  • lParam：接收輸入識別碼的位址 (DWORD *) 。

[in, out] wParam

reqId特有的其他資訊。

[in, out] lParam

reqId特有的其他資訊。

傳回值

如果 成功， 則S_OK，否則E_FAIL。

備註

可能的 IMEPADCTRL_* 值

當reqId設定為IMEPADREQ_SENDCONTROL時，這些是 wParam可以採用的可能值：
名稱 值 描述
IMEPADCTRL_CONVERTALL 1 轉換所有組合字元串。
IMEPADCTRL_DETERMINALL 2 判斷所有組合字元串。
IMEPADCTRL_DETERMINCHAR 3 判斷指定的計數組合字元串字元。
IMEPADCTRL_CLEARALL 4 清除所有組合字元串。
IMEPADCTRL_CARETLEFT 6 將字元插入號移至左側。
IMEPADCTRL_CARETRIGHT 7 將字元插入號移至右側。
IMEPADCTRL_CARETTOP 8 將字元插入號移至組合字元串的頂端。
IMEPADCTRL_CARETBOTTOM 9 將字元插入號移至組合字元串的結尾。
IMEPADCTRL_CARETBACKSPACE 10 在插入號 (之前刪除組合字元串的字元，例如 BACKSPACE 索引鍵) 。
IMEPADCTRL_CARETDELETE 11 在插入號 (之後刪除組合字元串的字元，例如 DELETE 索引鍵) 。
IMEPADCTRL_PHRASEDELETE 12 刪除組合字元串的片語。
IMEPADCTRL_INSERTSPACE 13 根據輸入法組態，插入空白字元—全形或半形。
IMEPADCTRL_INSERTFULLSPACE 14 插入全形空間。
IMEPADCTRL_INSERTHALFSPACE 15 插入半形空間。
IMEPADCTRL_ONIME 16 設定輸入法開啟。
IMEPADCTRL_OFFIME 17 設定 IME OFF。
IMEPADCTRL_ONPRECONVERSION 18 設定預先轉換開啟。
IMEPADCTRL_OFFPRECONVERSION 19 設定預先轉換 OFF。
IMEPADCTRL_PHONETICCANDIDATE 20 開啟輸入法的候選項目。
 

可能的 IPAWS_* 值

這些是當 reqId設定為IMEPADREQ_GETAPPLETUISTYLE時可透過wParam接收的可能值，或者當reqId設定為IMEPADREQ_SETAPPLETUISTYLE時，可以將 wParam設定為 ：
名稱 描述
IPAWS_ENABLED 將小程式顯示為已啟用的視窗。
IPAWS_SIZINGNOTIFY 將 IMEPN_SIZECHANGING 或 IMEPN_SIZECHANGED 通知程式碼傳送給小程式代碼。
IPAWS_VERTICALFIXED 垂直固定。
IPAWS_HORIZONTALFIXED 水準固定。
IPAWS_SIZEFIXED 大小是固定的。
IPAWS_MAXWIDTHFIXED 最大寬度是固定的。
IPAWS_MAXHEIGHTFIXED 固定高度上限。
IPAWS_MAXSIZEFIXED 大小上限是固定的。
IPAWS_MINWIDTHFIXED 最小寬度是固定的。
IPAWS_MINHEIGHTFIXED 固定高度下限。
IPAWS_MINSIZEFIXED 最小大小是固定的。

需求

   
目標平台 Windows
標頭 imepad.h

另請參閱

IImePad

IImePad Applet

IMECOMPOSITIONSTRINGINFO