PenInputPanel.InputFailed 事件
已取代。 PenInputPanel已由文字輸入面板取代 (TIP) 。
當 PenInputPanel 物件能夠在附加控制項中插入使用者輸入之前變更輸入時發生。
語法
HRESULT InputFailed(
[in] long hWnd,
[in] long Key,
[in] BSTR Text,
[in] short ShiftKey
);
參數
-
hWnd [in]
-
叫用 PenInputPanel 物件的控制項視窗控制碼。
-
機碼 [in]
-
對應至按下按鍵的虛擬按鍵。
-
文字 [in]
-
當引發InputFailed事件時，要插入hWnd參數所代表之控制項中的字串。
如需 BSTR 資料類型的詳細資訊，請參閱 使用 COM 程式庫。
-
ShiftKey [in]
-
鍵盤修飾詞的狀態，包括 SHIFT、CAPS、CTRL 和 ALT。
傳回值
如果此事件成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。
備註
在使用者輸入插入附加控制項之前，輸入焦點變更時，就會發生 InputFailed 事件。 例如，如果使用者在手寫板中輸入筆跡，則在辨識器有機會完成之前，點選另一個編輯控制項，就會引發此事件。
使用傳遞至此事件的視窗控制碼，您可以選擇在發生此事件時自行插入文字。
注意
從 Microsoft Windows XP 平板電腦版本 2005 開始， InputFailed 事件已不再適用。 文字一律會在焦點變更之前插入。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
| 最低支援的伺服器 |
都不支援 |
| 標頭 |
|
| 程式庫 |
|
另請參閱