Compartilhar via


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

Inicializa e ativa o TSF para o thread de chamada com um sinalizador que especifica 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 esse método 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 esse método é chamado. O layout do teclado será ajustado quando o thread de chamada ficar em 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 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h

Confira também

ITfThreadMgr2