Método ITfDocumentMgr::P ush (msctf.h)
Adiciona um contexto à parte superior da pilha de contexto.
Sintaxe
HRESULT Push(
[in] ITfContext *pic
);
Parâmetros
[in] pic
Ponteiro para o objeto ITfContext a ser adicionado à pilha. Esse objeto é obtido de uma chamada anterior para ITfDocumentMgr::CreateContext.
Retornar valor
Esse método pode retornar um desses valores.
| Valor | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
pic é inválido. |
|
Não existe espaço na pilha para o contexto. A pilha de contexto tem um limite de dois contextos. |
|
Esse método foi chamado durante uma chamada ITfDocumentMgr::P op . |
Comentários
O primeiro contexto adicionado à pilha torna-se o contexto main documento.
O gerenciador de TSF e os serviços de texto interagem apenas com o contexto na parte superior da pilha. Normalmente, somente o contexto do documento main está na pilha. Ocasionalmente, é necessário adicionar um segundo contexto à pilha. Por exemplo, quando um serviço de texto deve exibir uma interface do usuário modal, como uma lista de candidatos. Durante esse tempo, o serviço de texto adicionará seu contexto à pilha. Quando a interface do usuário do serviço de texto não é mais necessária, o serviço de texto remove o contexto da pilha. O contexto main retorna para a parte superior da pilha. Para simplificar esse processo e impedir que várias interfaces do usuário modais sejam exibidas, há um máximo de dois contextos permitidos na pilha.
Esse método faz com que o método ITfThreadMgrEventSink::OnPushContext de todos os coletores de eventos do gerenciador de threads instalados seja chamado. Se esse for o primeiro contexto a ser adicionado à pilha, esse método fará com que o método ITfThreadMgrEventSink::OnInitDocumentMgr de todos os coletores de eventos do gerenciador de threads instalados seja chamado.
ITfDocumentMgr::P op deve ser chamado para remover esse contexto da pilha de contexto.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |