Share via

MAPIFolder Object

Multiple objects

Represents a Microsoft Outlook folder. A MAPIFolder object can contain other MAPIFolder objects, as well as Outlook items. You can navigate nested folders by using a combination of Folders (index), which returns a folder within a name space or another folder, and the Parent property, which returns the containing object.

Note  Search folders are not MAPIFolder objects and therefore, the methods and properties of a MAPIFolder object will not work on search folders.

Using the MAPIFolder Object

Use Folders(index), where index is the name or index number, to return a single MAPIFolder object from a NameSpace object or another MAPIFolder object.

There is a set of folders within an Outlook data store that support the default functionality of Outlook. Use GetDefaultFolder (index), where index is one of the OlDefaultFolders constants to return one of the default Outlook folders in the Outlook NameSpace object. The OlDefaultFolders constants are olFolderCalendar, olFolderContacts, olFolderDeletedItems, olFolderDrafts, olFolderInbox, olFolderJournal, olFolderNotes, olFolderOutbox, olFolderSentMail, olFolderTasks, olPublicFoldersAllPublicFolders, and olFolderJunk.

Use the Add method to add a folder to the Folders object. The Add method has an optional argument that can be used to specify the type of items that can be stored in that folder. By default, folders created inside another folder inherit the type of the parent folder.

Folders within the Outlook data store can be typed; for example, the Calendar folder will only contain AppointmentItem objects and the Contacts folder will only contain ContactItem and DistListItem objects.

Note that when items of a specific type are saved, they are saved directly into their corresponding default folder. For example, when the GetAssociatedAppointment method is applied to a MeetingItem in the Inbox folder, the appointment that is returned will be saved to the default Calendar folder.

Properties | AddressBookName Property | Application Property | Class Property | CurrentView Property | CustomViewsOnly Property | DefaultItemType Property | DefaultMessageClass Property | Description Property | EntryID Property | FolderPath Property | Folders Property | InAppFolderSyncObject Property | IsSharePointFolder Property | Items Property | Name Property | Parent Property | Session Property | ShowAsOutlookAB Property | ShowItemCount Property | StoreID Property | UnReadItemCount Property | Views Property | WebViewOn Property | WebViewURL Property

Methods | AddToFavorites Method | AddToPFFavorites Method | CopyTo Method | Delete Method | Display Method | GetExplorer Method | MoveTo Method

Parent Objects | Explorer Object | MailItem Object | MeetingItem Object

Child Objects | View Object