IMAPIForm::SetViewContext
Aplica-se a: Outlook 2013 | Outlook 2016
Estabelece um contexto de exibição para o formulário.
HRESULT SetViewContext(
LPMAPIVIEWCONTEXT pViewContext
);
Parâmetros
pViewContext
[in] Um ponteiro para o novo contexto de exibição do formulário.
Valor de retorno
S_OK
O contexto de exibição foi definido com êxito.
Comentários
Os visualizadores de formulário chamam o método IMAPIForm::SetViewContext para estabelecer um contexto de exibição de formulário específico como atual. Um formulário pode ter apenas um contexto de exibição por vez.
Observações para implementadores
A maioria dos servidores de formulário implementa SetViewContext usando o seguinte algoritmo:
Se já existir um contexto de exibição para o formulário, cancele o registro do formulário chamando o método IMAPIViewContext::SetAdviseSink com null no parâmetro pmnvs e chame o método IUnknown::Release do contexto de exibição para decrescente sua contagem de referência.
Se o novo contexto de exibição não for nulo, chame IMAPIViewContext::SetAdviseSink usando o parâmetro pViewContext para configurar um novo coletor de consultoria de exibição.
Se o novo contexto de exibição não for nulo, chame o método IMAPIViewContext::GetViewStatus para determinar quais sinalizadores status foram definidos.
Se o novo contexto de exibição não for nulo, armazene-o e chame seu método IUnknown::AddRef para incrementar sua contagem de referência.
Atualize todos os elementos de interface do usuário que dependem do contexto de exibição.
Dependendo do status sinalizadores retornados de IMAPIViewContext::GetViewStatus, SetViewContext também pode executar outras ações. Por exemplo, se os sinalizadores VCSTATUS_NEXT e VCSTATUS_PREV forem retornados, SetViewContext poderá habilitar os botões Avançar e Anterior para o novo contexto de exibição.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
O MFCMAPI usa o método IMAPIForm::SetViewContext para definir o contexto de exibição do MFCMAPI no formulário antes que o formulário seja exibido. |
Confira também
IMAPIViewContext::GetViewStatus