Compartilhar via


Evento DocumentItem.BeforeRead (Outlook)

Ocorre antes que o Microsoft Outlook comece a ler as propriedades do item.

Sintaxe

expression. BeforeRead

Expressão Uma variável que representa um objeto DocumentItem .

Comentários

O evento BeforeRead ocorre antes do evento de leitura. Ao contrário de outros eventos com o prefixo antes, esse evento não está pode ser cancelado. Para determinar quando o item seja descarregado da memória, use o evento Unload.

O evento BeforeRead corresponde ao evento iexchextmessageevents:: Onread Exchange cliente ECE (extensões).

Os seguintes membros do objeto de item podem ser acessados no evento BeforeRead:

A propriedade MAPIOBJECT é uma propriedade oculta no modelo de objeto do Outlook. Essa propriedade fornece acesso ao objeto subjacente MAPI IMessage e pode ser chamada somente através da interface IUnknown. A propriedade é acessível aos programas escritos em idiomas que suportam IUnknown como C ou C++. MAPIOBJECT não está disponível por meio da interface IDispatch. Idiomas de desenvolvimento, como o Visual Basic for Applications (VBA), Visual c# e Visual Basic oferecem suporte a interface IDispatch e IUnknown e, portanto, eles não podem acessar MAPIOBJECT. Se outras propriedades ou métodos do item pai são acessados nesse caso, o Outlook gerará um erro.

Se o implementador acessa as subjacentes IMessage objeto e altera as propriedades desse objeto, o Outlook será renderizado esse item refletindo as alterações ao objeto IMessage. O implementador não precisará chamar SaveChanges no objeto IMessage para fazer com que as alterações sejam refletidas no Outlook.

Implementadores devem liberar o objeto obtido com a propriedade MAPIOBJECT no evento antes do evento for concluído. Tentando usar esse objeto fora do contexto do evento não é suportado e levarão à redução comportamento imprevisível.

Confira também

Objeto DocumentItem

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.