Compartir a través de


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

Notifica al host de texto que el control está activo.

Sintaxis

HRESULT TxActivate(
  LONG *plOldState
);

Parámetros

plOldState

Tipo: LONG*

Estado de activación anterior.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si el método se realiza correctamente.

Devuelve el siguiente código de error COM si se produce un error en el método. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Código devuelto Descripción
E_FAIL
La activación no es posible en este momento.

Comentarios

Es legal que el host rechace una solicitud de activación; por ejemplo, el control puede minimizarse y, por tanto, ser invisible.

El autor de la llamada debe ser capaz de controlar correctamente el error de activación.

Independientemente de cuántas veces se llame a este método, solo se necesita una llamada ITextHost::TxDeactivate para desactivar el control.

Esta función devuelve un identificador opaco en plOldState. El autor de la llamada (el objeto de servicios de texto) debe guardar este identificador y usarlo en una llamada posterior a ITextHost::TxDeactivate.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado textserv.h
Archivo DLL Msftedit.dll

Consulte también

Conceptual

ITextHost

Referencia

TxDeactivate

Controles de edición enriquecida sin ventanas