ItemProperties Collection

ItemProperties Collection

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.


A collection of all properties associated with the item.

Using the ItemProperties collection

Use the ItemProperties property to return the ItemProperties collection. Use ItemProperties.Item(index), where index is the name of the object or the numeric position of the item within the collection, to return a single ItemProperty object. The following example creates a new MailItem object and stores its ItemProperties collection in a variable called objItems.

Sub ItemProperty()
'Creates a new MailItem and access its properties

    Dim olApp As Outlook.Application
    Dim objMail As MailItem
    Dim objItems As ItemProperties
    Dim objItem As ItemProperty

    Set olApp = Outlook.Application
    'Create the mail item
    Set objMail = olApp.CreateItem(olMailItem)
    'Create a reference to the item properties collection
    Set objItems = objMail.ItemProperties
    'Create a reference to the item property page
    Set objItem = objItems.item(0)

End Sub

Use the Add method to add a new item property to the ItemProperties collection. Use the Remove method to remove an item property from the ItemProperties collection.

Note  You can only add or remove custom properties. Custom properties are denoted by the IsUserProperty.

Note  The ItemProperties collection is zero-based, meaning that the first item in the collection is referenced by 0, instead of 1.

© 2015 Microsoft