Share via


Recipient Object

Outlook Developer Reference

Represents a user or resource in Outlook, generally a mail message addressee.

Remarks

Use Recipients(

index

), where

index

is the name or index number, to return a single Recipient object. The name can be a string representing the display name, the alias, or the full SMTP e-mail address of the recipient.

Use the Add method to create a new Recipient object and add it to the Recipients object. The Type property of a new Recipient object is set to the default for the associated AppointmentItem, JournalItem, MailItem, MeetingItem or TaskItem object and must be reset to indicate another recipient type.

Example

The following Visual Basic for Applications (VBA) example creates a new MailItem object and adds Jon Grande as the recipient using the default type ("To").

Visual Basic for Applications
  Set myItem = Application.CreateItem(olMailItem)
Set myRecipient = myItem.Recipients.Add ("Jon Grande")

The following Visual Basic for Applications example creates the same MailItem object as the preceding example, and then changes the type of the Recipient object from the default (To) to CC.

Visual Basic for Applications
  Set myItem = Application.CreateItem(olMailItem)
Set myRecipient = myItem.Recipients.Add ("Jon Grande")
myRecipient.Type = olCC

See Also