Addresses

A collection of Address objects.

Properties

The following table lists properties along with their access and descriptions.

Property

Access

Description

Application

R/O

Application. The Application object.

Count

R/O

Long. The number of objects in this collection.

_NewEnu m

R/O

Enumeration object. Implements IEnumVARIANT. For Windows only.

Parent

R/O

Object. The Application object or the AddressBookEntries collection that owns this collection.

Methods

Add(VARIANT Address)

Adds an existing address or list of addresses to this collection. Address may be an Address object, an AddressBookEntry object, or an Addresses collection. If Address is an Addresses collection, each Address in that collection is added.

Address Item(VARIANT Index)

DEFAULT. Returns the Address object specified by Index. Index may be a Long, a string representing a Long, or an Address object. If Index is a Long or a string representing a Long, returns the Address object located at the given Index in the collection. Valid indexes are 1 through Count, inclusive. Throws an exception if the Index is outside of this range. If Index is an Address object, it should contain the DisplayName, EmailAddress, EmailType, and ObjType of the desired Address object. Depending on the amount of supplied information, the specified address can be ambiguous, in which case the first item that is considered a match is returned.

Remove(VARIANT Index)

Removes the address, specified by Index, from the collection. Index may be a Long, a string representing a Long, or an Address object. If Index is a Long, or a string representing a Long, removes the Address object located at the given Index in the collection. Valid indexes are 1 through Count, inclusive. Throws an exception if the Index is outside of this range. If Index is an Address object, it should contain the DisplayName, EmailAddress, EmailType, and ObjType of the desired Address object.

Remarks

An Addresses collection is refreshed when its parent object is refreshed. When an Addresses collection is refreshed, it recursively refreshes its contained Address objects.