Método ITfKeystrokeMgr::AdviseKeyEventSink (msctf.h)

Instala um coletor de eventos de tecla para receber eventos de teclado.

Sintaxe

HRESULT AdviseKeyEventSink(
  [in] TfClientId      tid,
  [in] ITfKeyEventSink *pSink,
  [in] BOOL            fForeground
);

Parâmetros

[in] tid

Identificador do cliente que possui o coletor de eventos de chave. Esse valor é obtido por uma chamada anterior para ITfThreadMgr::Activate.

[in] pSink

Ponteiro para uma interface ITfKeyEventSink .

[in] fForeground

Especifica se esse coletor de eventos de chave é feito o coletor de eventos da chave de primeiro plano. Se for TRUE, esse coletor de eventos de chave será transformado no coletor de eventos da chave de primeiro plano. Caso contrário, esse coletor de eventos de chave não se tornará o coletor de eventos da chave de primeiro plano.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
CONNECT_E_ADVISELIMIT	O cliente identificado pelo tid tem um coletor de eventos de chave instalado.

Comentários

O coletor de eventos da tecla de primeiro plano recebe todos os eventos de teclado. Um coletor de eventos de chave não em primeiro plano recebe apenas chaves preservadas e eventos de chave que ocorrem no texto marcado como propriedade do identificador do cliente.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional

Confira também

ITfKeyEventSink

ITfKeystrokeMgr

ITfThreadMgr::Activate