共用方式為


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 [僅限傳統型應用程式]
最低支援的伺服器
都不支援
標頭
Msinkaut.h (也需要 Msinkaut_i.c)
程式庫
InkObj.dll

另請參閱

PenInputPanel