Método ITextHost::TxActivate (textserv.h)

Artigo
08/26/2023

Notifica o host de texto de que o controle está ativo.

Sintaxe

HRESULT TxActivate(
  LONG *plOldState
);

Parâmetros

plOldState

Tipo: LONG*

O estado de ativação anterior.

Valor retornado

Tipo: HRESULT

Retorne S_OK se o método for bem-sucedido.

Retornará o código de erro COM a seguir se o método falhar. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno	Descrição
E_FAIL	A ativação não é possível no momento.

Comentários

É legal que o host recuse uma solicitação de ativação; por exemplo, o controle pode ser minimizado e, portanto, invisível.

O chamador deve ser capaz de lidar normalmente com a falha de ativação.

Não importa quantas vezes esse método seja chamado, apenas uma chamada ITextHost::TxDeactivate é necessária para desativar o controle.

Essa função retorna um identificador opaco em plOldState. O chamador (o objeto de serviços de texto) deve salvar esse identificador e usá-lo em uma chamada subsequente para ITextHost::TxDeactivate.

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