Item Property (CDONTS Recipients Collection)

The Item property returns a single Recipient object from the Recipients collection. Read-only.

Syntax

collRecips.Item(index) 
 

index

A long integer ranging from 1 to collRecips.Count, or a string that specifies the name of the object.

The Item property is the default property of a Recipients collection, meaning that collRecips(index) is syntactically equivalent to collRecips.Item(index) in Microsoft® Visual Basic® code.

Data Type

Object (Recipient)

Remarks

The Item property works like an accessor property for small collections.

Although the Item property itself is read-only, the Recipient object it returns can be accessed in the normal manner, and its properties retain their respective read/write or read-only accessibility.

Example

This code fragment shows the Count and Item properties working together:

' list all recipient names in the collection 
strRecips = "" ' initialize string 
Set collRecips = objMessage.Recipients 
Count = collRecips.Count 
For i = 1 To Count Step 1 
    Set objRecip = collRecips.Item(i) ' or collRecips(i) 
    strRecips = strRecips & objRecip.Name & "; " 
Next i 
MsgBox "Message recipients: " & strRecips