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 |
|---|---|
|
O método foi bem-sucedido. |
|
A pilha está vazia ou esse método é chamado sem o sinalizador TF_POPF_ALL e apenas um único contexto está na pilha. |
|
Esse método foi chamado durante outra chamada ITfDocumentMgr::P op . |
|
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 |