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

Remove o contexto da parte superior da pilha de contexto.

Sintaxe

HRESULT Pop(
  [in] DWORD dwFlags
);

Parâmetros

[in] dwFlags

Se esse valor for 0, somente o contexto na parte superior da pilha será removido. Se esse valor for TF_POPF_ALL, todos os contextos serão removidos da pilha.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	A pilha está vazia ou esse método é chamado sem o sinalizador TF_POPF_ALL e apenas um único contexto está na pilha.
E_UNEXPECTED	Esse método foi chamado durante outra chamada ITfDocumentMgr::P op .
E_INVALIDARG	dwFlags é inválido.

Comentários

Esse método deve ser chamado do mesmo thread que a chamada ITfDocumentMgr::P ush correspondente.

O primeiro contexto adicionado à pilha torna-se o contexto primário. O contexto primário não pode ser removido da pilha sem usar o sinalizador TF_POPF_ALL. Quando o documento não é inicializado, esse método deve ser chamado com o sinalizador TF_POPF_ALL. Isso faz com que o gerenciador de documentos remova todos os contextos da pilha de contexto e encerre qualquer interface do usuário do serviço de texto. Não use o sinalizador TF_POPF_ALL em nenhum outro momento.

Esse método faz com que o método ITfThreadMgrEventSink::OnPopContext de todos os coletores de eventos do gerenciador de threads instalados seja chamado. Se o último contexto for removido da pilha, esse método fará com que o método ITfThreadMgrEventSink::OnUninitDocumentMgr de todos os coletores de eventos do gerenciador de threads instalados seja chamado.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional

Confira também

ITfDocumentMgr

ITfDocumentMgr::P ush

ITfThreadMgrEventSink::OnPopContext

ITfThreadMgrEventSink::OnUninitDocumentMgr