Share via


Documents Collection Object

If your application supports a multiple-document interface (MDI), you should provide a Documents collection object. Use the name Documents for this collection, unless the name is inappropriate for the application.

The Documents collection object should have all of the following properties.

Property name Return type Description
Application
VT_DISPATCH
Returns the Application object; read only. Required.
Count
VT_I4
Returns the number of items in the collection; read only. Required.
_NewEnum
VT_DISPATCH
A special property that returns an enumerator object that implements IEnumVARIANT. Required.
Parent
VT_DISPATCH
Returns the parent of the Documents collection object; read only. Required.

The Documents collection object should have all of the following methods.

Method name Return type Description
Add
VT_DISPATCH
Creates a new document and adds it to the collection. Returns the document that was created. Required.
Close
VT_EMPTY
Closes all documents in the collection. Required.
Item
VT_DISPATCH or VT_EMPTY
Returns a Document object from the collection or returns VT_EMPTY if the document does not exist. Takes an optional argument, index, which may be a string (VT_BSTR) indicating the document name, a number (VT_I4) indicating the ordered position within the collection, or either (VT_VARIANT). If index is omitted, returns the Document collection. The Item method is the default member (DISPID_VALUE). Required.
Open
VT_DISPATCH or VT_EMPTY
Opens an existing document and adds it to the collection. Returns the document that was opened, or VT_EMPTY if the object could not be opened. Takes one required argument, filename, and one optional argument, password. Both arguments have the type VT_BSTR. Required.