IMAPIFormAdviseSink::OnChange
Aplica-se a: Outlook 2013 | Outlook 2016
Indica que ocorreu uma alteração no status do visualizador de formulários.
HRESULT OnChange(
ULONG ulDir
);
Parâmetros
ulDir
[in] Um bitmask de sinalizadores que fornece informações sobre a alteração que ocorreu no visualizador e a resposta esperada no formulário. Os seguintes sinalizadores podem ser definidos:
VCSTATUS_CATEGORY
Há uma mensagem próxima ou anterior em outra categoria.
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 deve ser modal para o visualizador de formulários.
VCSTATUS_NEXT
Há uma próxima mensagem no visualizador de formulários.
VCSTATUS_PREV
Há uma mensagem anterior no visualizador de formulários.
VCSTATUS_READONLY
As operações Excluir, enviar e mover devem ser desabilitadas.
VCSTATUS_UNREAD
Há uma mensagem não lida próxima ou anterior no visualizador de formulários.
Valor de retorno
S_OK
A notificação foi bem-sucedida.
Comentários
Os visualizadores de formulário chamam o método IMAPIFormAdviseSink::OnChange para notificar o formulário sobre uma alteração no status de um visualizador. Normalmente, a única alteração é definir ou limpar o sinalizador VCSTATUS_NEXT ou VCSTATUS_PREVIOUS com base na presença ou ausência de uma mensagem próxima ou anterior no visualizador. Assim, o objeto de formulário habilita ou desabilita todas as ações próximas ou anteriores que ele dá suporte.
As configurações de VCSTATUS_MODAL e VCSTATUS_INTERACTIVE não podem ser alteradas em um contexto de exibição após a criação.
Observações para implementadores
A implementação específica desse método depende completamente das especificidades do formulário. A maioria dos objetos de formulário usa esse método para alterar a interface do usuário (por exemplo, para habilitar ou desabilitar comandos de menu ou botões para corresponder ao parâmetro visualizador status sinalizadores).