Compartilhar via


Método ITfTextInputProcessor::Activate (msctf.h)

Ativa um serviço de texto quando uma sessão de usuário é iniciada.

Sintaxe

HRESULT Activate(
  [in] ITfThreadMgr *ptim,
  [in] TfClientId   tid
);

Parâmetros

[in] ptim

Ponteiro para a interface ITfThreadMgr para o gerenciador de threads que possui o serviço de texto.

[in] tid

Especifica o identificador do cliente para o serviço de texto.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O TSF chama esse método depois de criar uma instância de um serviço de texto com uma chamada para CoCreateInstance. Isso permite que as operações necessárias iniciem o serviço de texto.

Esse método geralmente adiciona uma referência ao gerenciador de threads para a sessão e aconselha coletores para eventos que envolvem o serviço de texto, como alteração de foco, pressionamentos de tecla e eventos de janela. Ele também personaliza a barra de idiomas para o serviço de texto.

O método ITfTextInputProcessor::D ativado correspondente que desliga o serviço de texto deve liberar todas as referências ao parâmetro ptim .

Requisitos

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

Confira também

ITfTextInputProcessor

ITfTextInputProcessor::D ativar

ITfThreadMgr