Click here to Skip to main content
Click here to Skip to main content

Outlook 2007 Add-in Using Microsoft Visual C#.NET

, 24 Feb 2010
Rate this:
Please Sign up or sign in to vote.
Outlook 2007 add-in using Microsoft Visual C#.NET

Table of Contents


Many well known companies use the Microsoft Office System to operate their business. Microsoft Office system is both strong and powerful to operate your business information, but sometimes you may need some extra features into your Office system so that you can do some more complex tasks efficiently. That is the reason to build custom solutions and add-ins for Microsoft Office. Using Microsoft Visual Studio 2005 / 2008 Tools for the Microsoft Office System (VSTO), you can develop custom solutions to help solve the problems that your business needs to solve.

What We Learn

This article demonstrates how to develop an add-in for Microsoft Office Outlook 2007 to help a fictitious company. You will learn how add custom menus, toolbar command button, custom tabs (Outlook 2007), work with ribbon and custom forms as well.

Well… I hope that you are enjoying; let’s start. I try to categorize it into two parts as listed below:

Part - A

  1. We will discuss basic concepts how to build your first custom add-in for Office Outlook 2007.
  2. We will discuss how to add a custom menus, toolbar command button, custom tabs (Outlook 2007).

Part - B

This part is not included yet…. I hope that this will be available in the next part.

  • We will discuss how to work with different types of Outlook objects such as email, appointments, task, etc.

Basic Overview of Outlook 2007 Add-In

Develop an Outlook 2007 add-in using Microsoft Visual Studio .NET Framework 3.5, Microsoft Office System provides a basic Template for doing this. The templates are available in both Visual Basic and Visual C# languages. Each template includes the OutlookItem class, which enables developers to work with generic Outlook items through late-binding, without determining the item type first.

More information can be found at this link.

Outlook Object Model Overview

To develop add-ins for Microsoft Office Outlook, you can interact with the objects provided by the Outlook object model. The Outlook object model provides classes that represent items in the user interface. For example, the Microsoft.Office.Interop.Outlook.Application class represents the entire application, the Microsoft.Office.Interop.Outlook.MAPIFolder class represents a folder that contains e-mail messages or other items, and the Microsoft.Office.Interop.Outlook.MailItem class represents an e-mail message.

More information can be found at this link.

Build Your First Add-In for Outlook 2007 (Part - A)

In this section, we will discuss about creating your first add-in for Outlook 2007. Microsoft Visual Studio provides the template for creating an add-in for Microsoft Office system.

How to Create an Add-In project for Microsoft Office Outlook 07

To create a new Outlook 2007 Add-In project, we need to follow the step(s) listed below:

  • Open Microsoft Visual Studio .NET and create a new project by selecting “Project” menu under the File > New menu.
Figure - (i)


Figure (i) shows how to create a project using Microsoft Visual Studio 08.

  • A project type window will popup with the available language and available templates.
  • Select C# > Office > 2007 from the project type tree.
  • You will find the available templates, select Outlook 2007 add-in & finally enter your project name and click the Ok button for creating the project.
Figure - (ii)


Figure (ii) shows the available Template to create an add-in project for Office system.

Create Your First Custom Controls & Events

In this section, we will discuss how to add custom menus, toolbar command buttons, etc. For this purpose, we use the following:

  1. Office.CommandBar
  2. Office.CommandBarPopup
  3. Office.CommandBarButton

Create a Custom Menu

This example below creates a Menu called “My Menu” in Microsoft Office Outlook 2007. Figure (iii) show the menu in your Outlook 07.

Figure - (iii)


Code Snippets

 #region "Outlook07 Menu"
        private void MyMenuBar()
        { this.ErsMyMenuBar();
                //Define the existent Menu Bar
                _objMenuBar = this.Application.ActiveExplorer().CommandBars.ActiveMenuBar;
                //Define the new Menu Bar into the old menu bar
                _objNewMenuBar = (Office.CommandBarPopup)
                                                        , missing
                                                        , missing
                                                        , missing , false);
                if (_objNewMenuBar != null)
                    _objNewMenuBar.Caption = "My Menu";
                    _objNewMenuBar.Tag = menuTag;
                    _objButton = (Office.CommandBarButton)_objNewMenuBar.Controls.
                    Add(Office.MsoControlType.msoControlButton, missing,
                        missing, 1, true);
                    _objButton.Style = Office.MsoButtonStyle.
                    _objButton.Caption = "My menu item.";
                    _objButton.FaceId = 500;
                    _objButton.Tag = "ItemTag";
                    _objButton.Click += 
           new Office._CommandBarButtonEvents_ClickEventHandler(_objButton_Click);
                    _objNewMenuBar.Visible = true;
            catch (System.Exception ex)
                System.Windows.Forms.MessageBox.Show("Error: " + ex.Message.ToString()
                                                   , "Error Message");
            }        }

Create a Custom Toolbar

This example creates a toolbar command button called “My ToolBar Button” in Microsoft Office Outlook 2007.
Figure (iv,v) shows the toolbar in your Outlook 07.

Figure - (iv)


Figure - (v)


Code Snippets

private void MyToolBar()
        {   try
                // Delete the existing instance, if applicable.
                Office.CommandBar _objTmpToolBar = 
                    .CommandBars.FindControl(missing, missing,
                   menuToolBarTag, true);
                if (_objTmpToolBar != null)
                    _objTmpToolBar.Delete();     // Add a new toolbar to the 
                    // CommandBars collection
                                // of the Explorer window.
                _objToolBar = this.Application.ActiveExplorer()
                    Office.MsoBarPosition.msoBarTop, false, true);
                if (_objToolBar != null)
                    // Add a button to the new toolbar.
                    _objNewToolBarButton = (Office.CommandBarButton)_objToolBar
                        missing, missing, 1, true);
                    _objNewToolBarButton.Style = Office.MsoButtonStyle
                    _objNewToolBarButton.Caption = "My ToolBar Button";
                    _objNewToolBarButton.FaceId = 65;
                    _objNewToolBarButton.Tag = menuToolBarTag;
                    _objNewToolBarButton.Click += 
           new Office._CommandBarButtonEvents_ClickEventHandler
                    _objNewToolBarButton.Visible = true;
            catch (System.Exception ex)
                System.Windows.Forms.MessageBox.Show("Error: " + ex.Message.ToString()
                                                   , "Error Message");


I hope that this may be helpful to you. Enjoy!


  • MSDN


  • 23rd February, 2010: Initial post


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

Md. Marufuzzaman
Bangladesh Bangladesh
Follow on   Twitter

Comments and Discussions

GeneralRe: My vote of 1 PinmentorMd. Marufuzzaman12-Dec-12 4:09 
GeneralRe: My vote of 1 PinprofessionalBrisingr Aerowing24-Aug-13 13:21 
GeneralMy vote of 3 PinmemberIngar Tødenes31-Oct-12 4:43 
QuestionApplication for outlook ribbon PinmemberSid_ga23423-Oct-12 4:09 
Dear Sir,
This is very good article. Can you give an application where you add the ribbon type command use this C# window add-on application?
Pls. revert this if possible on my mail id :
Siddhartha Ganguly Smile | :) Smile | :)
QuestionHi PinmemberMP TP4-Apr-12 2:37 
AnswerRe: Hi PinmentorMd. Marufuzzaman4-Apr-12 3:29 
Question"Unable to cast COM object of type 'System.__ComObject' to interface type 'Microsoft.Office.Interop.Outlook.TaskItem'. This operation failed because the QueryInterface call on the COM component for the interface with IID '{00063035-0000-0000-C000-000 Pinmembertaneem785130-Jan-12 6:52 
Questionoutlook 2010 addin Pinmemberrtalsaniya12-Dec-11 3:49 
AnswerRe: outlook 2010 addin PinmvpMd. Marufuzzaman12-Dec-11 4:24 
GeneralAdd HowTo put element in an existing menu Pinmemberserup9-Jun-11 20:25 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140721.1 | Last Updated 25 Feb 2010
Article Copyright 2010 by Md. Marufuzzaman
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid