Item Property (Views Collection)

Item Property (Views Collection)

Important  The Collaboration Data Objects (CDO) 1.2.1 Rendering objects are not installed by or supported for use with Exchange Server 2003 or later.

The Item property returns the specified CalendarView or TableView object from the Views collection. Read-only.

Syntax

objViewsColl.Item(index)

objViewsColl.Item(name)

index

A short integer ranging from 1 to objViewsColl.Count.

name

The display name of the CalendarView or TableView object to be selected from the Views collection.

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

Data Type

TableView object

Remarks

The Item property works like an accessor property.

If the specified view object is not found in the collection, the Item property returns Nothing.

The names of the predefined calendar views are "Daily" for a view with mode CdoModeCalendarDaily and "Weekly" for a view with mode CdoModeCalendarWeekly. The mode of the view is available from its Mode property.

You should give every view object a unique name. CDO does not enforce uniqueness, but if a collection has duplicate names, only the first one can be found by name.

Although the Item property itself is read-only, the CalendarView or TableView 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:

' Put all view names in a collection into a string array
Dim strItemName(100) As String
Dim i As Integer ' loop counter
' error handling omitted from this fragment ...
For i = 1 To objViewsColl.Count Step 1
   strItemName(i) = objViewsColl.Item(i).Name
   ' or = objViewsColl(i) since Item and Name are default properties
   If 100 = i Then ' max size of string array
      Exit Function
   End If
Next i
 

See Also

Concepts

Views Collection Object