Compartilhar via

Método ITfIntegratableCandidateListUIElement::OnKeyDown (ctffunc.h)

  • Artigo

Processa uma tecla press.

Sintaxe

HRESULT OnKeyDown(
  [in]  WPARAM wParam,
  [in]  LPARAM lParam,
  [out] BOOL   *pfEaten
);

Parâmetros

[in] wParam

Especifica o código de chave virtual da chave. Para obter mais informações sobre esse parâmetro, consulte o parâmetro wParam em WM_KEYDOWN.

[in] lParam

Especifica a contagem de repetição, o código de verificação, o sinalizador de chave estendida, o código de contexto, o sinalizador de estado-chave anterior e o sinalizador de estado de transição da chave. Para obter mais informações sobre esse parâmetro, consulte o parâmetro lParam em WM_KEYDOWN.

[out] pfEaten

TRUE se o evento de chave foi tratado; caso contrário, FALSE.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.

Comentários

O método OnKeyDown permite que um aplicativo pergunte ao serviço de texto se ele deseja processar uma determinada chave em um estilo de integração. O comportamento do método OnKeyDown pode depender do estilo de integração. Se o serviço de texto retornar *pfEaten=TRUE, o aplicativo não deverá fazer nenhum processamento da chave. Se FALSE for retornado, o aplicativo poderá executar sua própria ação em resposta à chave.

GUID_INTEGRATIONSTYLE_SEARCHBOX ({E6D1BD11-82F7-4903-AE21-1A6397CDE2EB}) permite uma implementação de uma experiência de teclado na qual o usuário pode mover o foco percebido do teclado da caixa de pesquisa para a lista de candidatos para pesquisar sugestões. O serviço de texto pode processar chaves como VK_UP e VK_DOWN antes que a Pesquisa as manipule para alterar seu estado interno.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ctffunc.h

Confira também

ITfIntegratableCandidateListUIElement