SetInputScope 函式 (inputscope.h)

設定指定視窗的輸入範圍。

語法

HRESULT SetInputScope(
  [in] HWND       hwnd,
  [in] InputScope inputscope
);

[in] hwnd

要設定範圍的視窗。

[in] inputscope

要與視窗建立關聯的輸入範圍。若要移除輸入範圍關聯，請將IS_DEFAULT傳遞至此參數。

值	意義
S_OK	此方法成功。

呼叫這個方法會取代與視窗相關聯的任何範圍。

應用程式必須呼叫這個方法，傳入IS_DEFAULT至 hwnd 參數，才能移除視窗終結前的輸入範圍關聯。

只有當視窗 (hwnd 參數) 且呼叫執行緒位於相同的執行緒時，此 API 才能運作。如果您針對不同執行緒的視窗呼叫此 API，它會因為E_INVALIDARG而失敗。

如果您在視窗上呼叫此方法 (hwnd 參數) 尚未與檔管理員相關聯，則不會傳送任何文字服務通知給感興趣的用戶端 (，例如可能想要回應範圍變更的觸控式鍵盤) 。

[C++]

下列程式碼說明如何設定視窗的輸入範圍。


SetInputScope(hwnd, IS_EMAIL_USERNAME);