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 |
|---|---|
|
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
Referencia