SolutionsModule Object (Outlook)

Represents the Solutions navigation module in the Navigation Pane of an explorer.

Version Information

Version Added: Outlook 2010

Remarks

The Solutions navigation module contains folders that developers of individual add-ins want to expose to users in the Navigation Pane. Each solution has one root folder under the Solutions module, and each root folder can contain subfolders that hold heterogeneous Outlook items.

To add solution folders programmatically to the Solutions module, use the SolutionsModule object, which is derived from the NavigationModule object.

To obtain an object for the Solutions module, you must first determine whether the Solutions module exists in the Navigation Pane. To do that, use the Modules property for the NavigationPane object to obtain a NavigationModules collection, and then specify the argument olModuleSolutions in the GetNavigationModule method of the NavigationModules collection.

If the call is successful, you can then cast the returned NavigationModule object reference as a SolutionsModule object to access the properties and methods for that navigation module.

To add a solution root folder and its subfolders, pass a Folder object reference to the AddSolution method of the SolutionsModule object. The default position of the Solutions module on the Navigation Pane is '9'.

If no solutions have been added to the Solutions module, it is not visible in the Navigation Pane, and any attempt to set the Position or the Visible properties of the SolutionsModule object raises an error. In addition, any attempt to set the SolutionsModule as the CurrentModule property of the NavigationPane object raises an error.

Example

To see an example of an add-in that adds folders to the Solutions module, see the article Programming the Outlook 2010 Solutions Module on MSDN. The add-in in the article renames the Solutions module as Solution Demo, adds calendar, contacts, and tasks folders as subfolders to the solution root folder, sets custom icons for each of the subfolders, and customizes the Navigation Pane to move and enlarge the button for the Solution Demo module.

See Also

Concepts

SolutionsModule Object Members

Outlook Object Model Reference