Método ITfDocumentMgr::P ush (msctf.h)

Artículo
08/24/2023

Agrega un contexto a la parte superior de la pila de contexto.

Sintaxis

HRESULT Push(
  [in] ITfContext *pic
);

Parámetros

[in] pic

Puntero al objeto ITfContext que se va a agregar a la pila. Este objeto se obtiene de una llamada anterior a ITfDocumentMgr::CreateContext.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	pic no es válido.
TF_E_STACKFULL	No existe espacio en la pila para el contexto. La pila de contexto tiene un límite de dos contextos.
E_UNEXPECTED	Se llamó a este método durante una llamada ITfDocumentMgr::P op .

Comentarios

El primer contexto agregado a la pila se convierte en el contexto del documento principal.

El administrador de TSF y los servicios de texto solo interactúan con el contexto en la parte superior de la pila. Normalmente, solo el contexto del documento principal está en la pila. En ocasiones, es necesario agregar un segundo contexto a la pila. Por ejemplo, cuando un servicio de texto debe mostrar una interfaz de usuario modal, como una lista candidata. Durante este tiempo, el servicio de texto agregará su contexto a la pila. Cuando la interfaz de usuario del servicio de texto ya no es necesaria, el servicio de texto quita el contexto de la pila. A continuación, el contexto principal vuelve a la parte superior de la pila. Para simplificar este proceso e impedir que se muestren varias INTERFACES modales, hay un máximo de dos contextos permitidos en la pila.

Este método hace que se llame al método ITfThreadMgrEventSink::OnPushContext de todos los receptores de eventos del administrador de subprocesos instalados. Si este es el primer contexto que se va a agregar a la pila, este método hace que se llame al método ITfThreadMgrEventSink::OnInitDocumentMgr de todos los receptores de eventos del administrador de subprocesos instalados.

Se debe llamar a ITfDocumentMgr::P op para quitar este contexto de la pila de contextos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional