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