Item Property (CDONTS Recipients Collection)

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

 

See Also

Concepts

Recipients Collection Object (CDONTS Library)