Método ITextServices::OnTxInPlaceDeactivate (textserv.h)

Artigo
03/05/2024

Notifica o objeto de serviços de texto de que esse controle não está mais ativo no local.

Sintaxe

HRESULT OnTxInPlaceDeactivate();

Retornar valor

Tipo: HRESULT

O valor retornado é sempre S_OK.

Comentários

A ativação in-loco refere-se a um objeto inserido em execução no local (por exemplo, para controles regulares e inserções, ele teria uma janela para desenhar). Por outro lado, a interface do usuário ativa significa que um objeto atualmente tem o foco de edição. Especificamente, itens como menus e barras de ferramentas no contêiner também podem conter elementos do controle/inserção ativo da interface do usuário. Só pode haver um controle ativo da interface do usuário a qualquer momento, enquanto muitos podem estar ativos in-loco ao mesmo tempo.

Observe que a ativação da interface do usuário é diferente de obter o foco. Para que o objeto de serviços de texto saiba que o controle está recebendo ou perdendo o foco, o host enviará mensagens WM_SETFOCUS e WM_KILLFOCUS . Além disso, observe que um host sem janelas passará NULL como o wParam (janela que perdeu o foco) para essas mensagens.

Ao fazer a transição do estado ativo da interface do usuário para um estado não ativo, o host deve chamar ITextServices::OnTxUIDeactivate primeiro e, em seguida, ITextServices::OnTxInPlaceDeactivate.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	textserv.h
DLL	Msftedit.dll