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

Artículo
08/26/2023

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