Método ITextServices::OnTxInPlaceActivate (textserv.h)

Artículo
08/26/2023

Notifica al objeto de servicios de texto que este control está activo en contexto.

Sintaxis

HRESULT OnTxInPlaceActivate(
  [in] LPCRECT prcClient
);

Parámetros

[in] prcClient

Tipo: const RECT*

Rectángulo de cliente del control.

Valor devuelto

Tipo: HRESULT

Si el objeto se activa correctamente, se S_OK el valor devuelto.

Si no se pudo activar el objeto debido a un error, se E_FAIL el valor devuelto. Para obtener más información sobre los códigos de error COM, vea Control de errores en COM.

Comentarios

Activo en contexto significa que un objeto incrustado se está ejecutando en contexto (por ejemplo, para controles normales e incrustaciones, tendría una ventana en la que dibujar). Por el contrario, la interfaz de usuario activa significa que un objeto tiene actualmente el foco de edición. Por ejemplo, elementos como menús y barras de herramientas del contenedor también pueden contener elementos del control o la inserción activo de la interfaz de usuario. Solo hay un control activo de la interfaz de usuario en un momento dado, mientras que puede haber muchos controles activos en contexto.

Tenga en cuenta que la activación de la interfaz de usuario es diferente de la obtención del foco. Para indicar el objeto de servicios de texto que el control obtiene o pierde el foco, el host envía WM_SETFOCUS y WM_KILLFOCUS mensajes. Además, tenga en cuenta que un host sin ventana pasará NULL como wParam (ventana que perdió el foco) para estos mensajes.

Al realizar la transición directamente desde un estado no activo a la interfaz de usuario activa, el host debe llamar primero a ITextServices::OnTxInPlaceActivate y, a continuación, ITextServices::OnTxUIActivate.

ITextServices::OnTxInPlaceActivate toma como parámetro el rectángulo de cliente de la vista que se está activando. Este rectángulo se especifica en las coordenadas de cliente de la ventana contenedora. Es lo mismo que se obtendría llamando a TxGetClientRect en el host.

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