Método ITfThreadMgrEx::ActivateEx (msctf.h)

  • Artigo

O método ITfThreadMgrEx::ActivateEx é usado por um aplicativo para inicializar e ativar o TSF para o thread de chamada. Ao contrário de ITfThreadMgr::Activate, ITfThreadMgrEx::ActivateEx pode usar um sinalizador para especificar como o TSF é ativado.

Sintaxe

HRESULT ActivateEx(
  [out] TfClientId *ptid,
  [in]  DWORD      dwFlags
);

Parâmetros

[out] ptid

[out] Ponteiro para um valor TfClientId que recebe um identificador de cliente.

[in] dwFlags

Valor Significado
TF_TMAE_NOACTIVATETIP
 Os serviços de texto não serão ativados enquanto ITfThreadMgrEx::ActivateEx for chamado. Eles serão ativados quando o thread de chamada tiver o foco de forma assíncrona.
TF_TMAE_SECUREMODE
 O TSF é ativado no modo seguro. Somente os serviços de texto que dão suporte ao modo seguro serão ativados.
TF_TMAE_UIELEMENTENABLEDONLY
 O TSF ativa apenas os serviços de texto categorizados em GUID_TFCAT_TIPCAP_UIELEMENTENABLED.
TF_TMAE_COMLESS
 O TSF não usa COM. O TSF ativa apenas os serviços de texto categorizados em GUID_TFCAT_TIPCAP_COMLESS.
TF_TMAE_NOACTIVATEKEYBOARDLAYOUT
 O TSF não sincroniza o layout do teclado atual enquanto ITfThreadMgrEx::ActivateEx() é chamado. O layout do teclado será ajustado quando o thread de chamada receber foco. Esse sinalizador deve ser usado com TF_TMAE_NOACTIVATETIP.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
E_FAIL
 Ocorreu um erro não especificado.
E_INVALIDARG
 Um ou mais parâmetros são inválidos.

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 Msctf.dll
Redistribuível TSF 1.0 no Windows 2000 Professional

Confira também

ITfThreadMgr::Activate

ITfThreadMgrEx