IMAPIViewContext::GetViewStatus
Aplica-se a: Outlook 2013 | Outlook 2016
Recupera o status do visualizador atual.
HRESULT GetViewStatus(
ULONG FAR * lpulStatus
);
Parâmetros
lpulStatus
[out] Ponteiro para um bitmask de sinalizadores fornecendo o status do visualizador. Os seguintes sinalizadores podem ser definidos:
VCSTATUS_CATEGORY
Há uma mensagem próxima ou anterior em outra categoria.
VCSTATUS_DELETE
O formulário permite que as mensagens sejam removidas.
VCSTATUS_INTERACTIVE
O formulário deve exibir uma interface do usuário. Se esse sinalizador não estiver definido, o formulário deverá suprimir a exibição de uma interface do usuário mesmo em resposta a um verbo que geralmente faz com que uma interface do usuário seja exibida.
VCSTATUS_MODAL
O formulário é modal para o visualizador.
VCSTATUS_NEXT
Há uma próxima mensagem no modo de exibição.
VCSTATUS_PREV
Há uma mensagem anterior no modo de exibição.
VCSTATUS_READONLY
A mensagem deve ser aberta no modo somente leitura. As operações Excluir, enviar e mover devem ser desabilitadas.
VCSTATUS_UNREAD
Há uma mensagem não lida próxima ou anterior no modo de exibição.
Valor de retorno
S_OK
O status do espectador foi retornado com êxito.
Comentários
Objetos de formulário chamam o método IMAPIViewContext::GetViewStatus para determinar se há mais mensagens a serem ativadas em um modo de exibição de formulário em ambas as direções ou em ambas as direções, na direção em que um comando Next ativa mensagens, na direção em que um comando Anterior ativa mensagens ou em ambas as direções. O valor apontado pelo parâmetro lpulStatus é usado para determinar se os sinalizadores VCSTATUS_NEXT e VCSTATUS_PREV são válidos para IMAPIViewContext::ActivateNext. Se o sinalizador VCSTATUS_DELETE estiver definido, mas não o sinalizador VCSTATUS_READONLY, a mensagem poderá ser excluída usando o método IMAPIMessageSite::D eleteMessage .
Normalmente, os formulários desabilitarão comandos e botões de menu se eles não forem válidos para o contexto do visualizador. Um visualizador pode alertar um formulário para uma alteração no status chamando seu método IMAPIFormAdviseSink::OnChange.
O sinalizador VCSTATUS_MODAL será definido se o formulário precisar ser modal para a janela cujo identificador é passado na chamada IMAPIForm::D oVerb anterior. Se VCSTATUS_MODAL estiver definido, o formulário poderá usar o thread no qual a chamada DoVerb foi feita até que o formulário seja fechado. Se VCSTATUS_MODAL não estiver definido, o formulário não deverá ser modal para essa janela e não deverá usar o thread.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetViewStatus |
O MFCMAPI implementa o método IMAPIViewContext::GetViewStatus nesta função. |