Pular para o conteúdo principal
Este método é implementado do lado do cliente. Ele é chamado pelo ABBYY FineReader Engine quando uma tecla é pressionada no Image Viewer, Zoom Viewer, Text Editor, Text Validator ou Document Viewer. Ele fornece ao cliente o código da tecla, a contagem de repetições e as teclas modificadoras utilizadas. Esse método também permite cancelar a operação.

​
Sintaxe

​
C++

HRESULT OnKeyDown(
  int           KeyCode,
  int           Count,
  int           Flags,
  VARIANT_BOOL* Cancel
);

​
C#

void OnKeyDown(
  int      KeyCode,
  int      Count,
  int      Flags,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnKeyDown( _
  KeyCode As Integer, _
  Count As Integer, _
  Flags As Integer, _
  ByRef Cancel As Boolean _
)

​
Parâmetros

KeyCode [in] Especifica o código de tecla virtual da tecla pressionada. Count [in] Contém a contagem de repetição, ou seja, o número de vezes que o pressionamento de tecla se repete quando o usuário mantém a tecla pressionada. Flags [in] Contém o código de varredura, o código de transição da tecla, o estado anterior da tecla e o código de contexto, conforme mostrado na lista a seguir:
ValorDescrição
0-7Especifica o código de varredura. O valor depende do fabricante do equipamento original (OEM).
8Especifica se a tecla é estendida, como as teclas ALT e CTRL do lado direito presentes em um teclado aprimorado de 101 ou 102 teclas. O valor é 1 se for uma tecla estendida; caso contrário, é 0.
9-12Usado internamente pelo Windows.
13Especifica o código de contexto. O valor é 1 se a tecla ALT estiver pressionada enquanto a tecla é pressionada; caso contrário, o valor será 0.
14Especifica o estado anterior da tecla. O valor é 1 se a tecla estiver pressionada antes de a mensagem ser enviada, ou 0 se a tecla estiver solta.
15Especifica o estado de transição. O valor é 1 se a tecla estiver sendo liberada, ou 0 se estiver sendo pressionada.
Cancel [out] Você pode definir esta variável como TRUE para indicar que o processo deve ser encerrado.

​
Valores de retorno

[Somente C++] Se este método retornar um valor diferente de S_OK, isso indica que ocorreu um erro do lado do cliente e, nesse caso, o valor do Parameter Cancel não será levado em consideração.

​
Observações

A implementação cliente deste método deve garantir que todas as exceções lançadas dentro dele sejam capturadas e tratadas, e que nenhuma exceção seja propagada para fora do método. A propagação de uma exceção para fora do método pode levar a resultados imprevisíveis (como o encerramento do programa).

​
Veja também

IInputEvents