Compartilhar via

Evento MailItem.BeforeCheckNames (Outlook)

  • Artigo

Ocorre antes de o Microsoft Outlook iniciar a resolução de nomes na coleção de destinatários de um item (que é uma instância do objeto pai).

Sintaxe

expression. BeforeCheckNames( _Cancel_ )

expressão Uma variável que representa um objeto MailItem.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Cancel Obrigatório Boolean False quando o evento ocorre. Se o procedimento de evento define este argumento como True, o processo de resolução de nomes não será concluído.

Comentários

Você usa o evento BeforeCheckNames no VBScript, mas o evento não é disparado quando um nome de email é resolvido no formulário.

O evento não é acionado nas seguintes circunstâncias:

  • Quando você personaliza um formulário Entrada de Diário e, em seguida, resolve um contato no campo Contatos.

  • Quando você personaliza um formulário Contato e, em seguida, resolve um contato no campo Contatos.

  • Quando você personaliza qualquer tipo de formulário e o Outlook resolve o nome automaticamente em segundo plano.

  • Quando você cria e resolve um destinatário programaticamente.

Exemplo

Este exemplo Visual Basic for Applications (VBA) pergunta ao usuário se o usuário deseja resolver nomes e retorna False para cancelar a operação se o usuário responder não. O código de exemplo deve ser colocado em um módulo de classe como ThisOutlookSession, e o SendMail() procedimento deve ser chamado antes que o procedimento de evento possa ser chamado pelo Outlook.

Public WithEvents myItem As Outlook.MailItem 
 
 
 
Private Sub myItem_BeforeCheckNames(Cancel As Boolean) 
 
 If MsgBox("Do you want to resolve names now?", 4) = vbOK Then 
 
 Cancel = True 
 
 End If 
 
End Sub 
 
 
 
Public Sub SendMail() 
 
 Set myItem = Application.CreateItem(olMailItem) 
 
 myItem.Recipients.Add ("Dan Wilson") 
 
 myItem.Recipients.Add ("Nate Sun") 
 
 myItem.Body = "Good morning!" 
 
 myItem.Send 
 
End Sub

Confira também

Objeto MailItem

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.