Método ITfDocumentMgr::P ush (msctf.h)
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 |
|---|---|
|
Método realizado correctamente. |
|
pic no es válido. |
|
No existe espacio en la pila para el contexto. La pila de contexto tiene un límite de dos contextos. |
|
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 |