Método ITextHost::TxActivate (textserv.h)
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 |
|---|---|
|
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 |
Confira também
Conceitual
Referência