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

Artigo
08/26/2023

Notifica o objeto de serviços de texto de que esse controle está ativo in-loco.

Sintaxe

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

Parâmetros

[in] prcClient

Tipo: const RECT*

O retângulo do cliente do controle.

Valor retornado

Tipo: HRESULT

Se o objeto for ativado com êxito, o valor retornado será S_OK.

Se o objeto não puder ser ativado devido a um erro, o valor retornado será E_FAIL. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Comentários

Ativo in-loco significa que um objeto inserido está sendo executado in-loco (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. Por exemplo, 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. Há apenas um controle ativo da interface do usuário em um determinado momento, enquanto pode haver muitos controles ativos in-loco.

Observe que a ativação da interface do usuário é diferente de obter o foco. Para sinalizar ao objeto de serviços de texto que o controle está recebendo ou perdendo o foco, o host envia 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 diretamente de um estado não ativo para o estado ativo da interface do usuário, o host deve chamar ITextServices::OnTxInPlaceActivate primeiro e, em seguida, ITextServices::OnTxUIActivate.

ITextServices::OnTxInPlaceActivate usa como parâmetro o retângulo do cliente da exibição que está sendo ativada. Esse retângulo é fornecido nas coordenadas do cliente da janela que o contém. É o mesmo que seria obtido chamando TxGetClientRect no host.

Requisitos


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