Share via


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

Quita el contexto de la parte superior de la pila de contextos.

Sintaxis

HRESULT Pop(
  [in] DWORD dwFlags
);

Parámetros

[in] dwFlags

Si este valor es 0, solo se quita el contexto de la parte superior de la pila. Si este valor es TF_POPF_ALL, todos los contextos se quitan de la pila.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Descripción
S_OK
Método realizado correctamente.
E_FAIL
La pila está vacía o se llama a este método sin la marca TF_POPF_ALL y solo hay un único contexto en la pila.
E_UNEXPECTED
Se llamó a este método durante otra llamada ITfDocumentMgr::P op .
E_INVALIDARG
dwFlags no es válido.

Comentarios

Se debe llamar a este método desde el mismo subproceso que la llamada ITfDocumentMgr::P ush correspondiente.

El primer contexto agregado a la pila se convierte en el contexto principal. El contexto principal no se puede quitar de la pila sin usar la marca TF_POPF_ALL. Cuando el documento no está inicializado, se debe llamar a este método con la marca TF_POPF_ALL. Esto hace que el administrador de documentos quite todos los contextos de la pila de contextos y finalice cualquier interfaz de usuario del servicio de texto. No use la marca TF_POPF_ALL en ningún otro momento.

Este método hace que se llame al método ITfThreadMgrEventSink::OnPopContext de todos los receptores de eventos del administrador de subprocesos instalados. Si se quita el último contexto de la pila, este método hace que se llame al método ITfThreadMgrEventSink::OnUninitDocumentMgr de todos los receptores de eventos del administrador de subprocesos instalados.

Requisitos

   
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

Consulte también

ITfDocumentMgr

ITfDocumentMgr::P ush

ITfThreadMgrEventSink::OnPopContext

ITfThreadMgrEventSink::OnUninitDocumentMgr