Compartilhar via


Evento PenInputPanel.InputFailed

Preterido. O PenInputPanel foi substituído pelo Painel de Entrada de Texto (TIP).

Ocorre quando o foco de entrada é alterado antes de o objeto PenInputPanel ser capaz de inserir a entrada do usuário no controle anexado.

Sintaxe

HRESULT InputFailed(
  [in] long  hWnd,
  [in] long  Key,
  [in] BSTR  Text,
  [in] short ShiftKey
);

Parâmetros

hWnd [in]

O identificador de janela do controle que invocou o objeto PenInputPanel .

Chave [in]

A tecla virtual correspondente à tecla pressionada.

Texto [in]

A cadeia de caracteres que deveria ser inserida no controle representado pelo parâmetro hWnd quando o evento InputFailed foi acionado.

Para obter mais informações sobre o tipo de dados BSTR, consulte Usando a biblioteca COM.

ShiftKey [in]

O estado dos modificadores de teclado, incluindo SHIFT, CAPS, CTRL e ALT.

Valor retornado

Se esse evento for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

O evento InputFailed ocorre quando o foco de entrada é alterado antes da entrada do usuário ser inserida no controle anexado. Por exemplo, se o usuário inserir tinta no teclado de escrita, tocará em outro controle de edição antes que o reconhecedor tenha tido a chance de concluir, esse evento será acionado.

Usando o identificador de janela passado para esse evento, você pode optar por inserir o texto por conta própria quando esse evento ocorrer.

Observação

A partir do Microsoft Windows XP Tablet PC Edition 2005, o evento InputFailed não se aplica mais. O texto é sempre inserido antes que o foco seja alterado.

 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Cabeçalho
Msinkaut.h (também requer Msinkaut_i.c)
Biblioteca
InkObj.dll

Confira também

Peninputpanel