Click here to Skip to main content
15,867,568 members
Articles / Programming Languages / C#

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

Rate me:
Please Sign up or sign in to vote.
4.62/5 (35 votes)
24 Feb 2010CPOL4 min read 174.4K   5.3K   98   41
Outlook 2007 add-in using Microsoft Visual C#.NET

Table of Contents

Introduction

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 <code>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)

CreateProjectStep-1

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)

CreateProjectStep-2

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)

CustomMenu

Code Snippets

C#
#region "Outlook07 Menu"
       private void MyMenuBar()
       { this.ErsMyMenuBar();
          try
           {
               //Define the existent Menu Bar
               _objMenuBar = this.Application.ActiveExplorer().CommandBars.ActiveMenuBar;
               //Define the new Menu Bar into the old menu bar
               _objNewMenuBar = (Office.CommandBarPopup)
                                _objMenuBar.Controls.Add
               (Office.MsoControlType.msoControlPopup
                                                       , 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.
                       msoButtonIconAndCaption;
                   _objButton.Caption = "My menu item.";
                   //Icon
                   _objButton.FaceId = 500;
                   _objButton.Tag = "ItemTag";
                   //EventHandler
                   _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");
           }        }
       #endregion

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)

CustomCommandButton

Figure - (v)

ToolBar

Code Snippets

C#
private void MyToolBar()
        {   try
            {
                // Delete the existing instance, if applicable.
                Office.CommandBar _objTmpToolBar = 
        (Office.CommandBar)this.Application.ActiveExplorer()
                    .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()
                    .CommandBars.Add(menuToolBarTag,
                    Office.MsoBarPosition.msoBarTop, false, true);
                if (_objToolBar != null)
                {
                    // Add a button to the new toolbar.
                    _objNewToolBarButton = (Office.CommandBarButton)_objToolBar
                        .Controls.Add(Office.MsoControlType.msoControlButton,
                        missing, missing, 1, true);
                    _objNewToolBarButton.Style = Office.MsoButtonStyle
                        .msoButtonIconAndCaption;
                    _objNewToolBarButton.Caption = "My ToolBar Button";
                    _objNewToolBarButton.FaceId = 65;
                    _objNewToolBarButton.Tag = menuToolBarTag;
                    _objNewToolBarButton.Click += 
           new Office._CommandBarButtonEvents_ClickEventHandler
            (_objToolBarButton_Click);
                    _objNewToolBarButton.Visible = true;
                }
            }
            catch (System.Exception ex)
            {
                System.Windows.Forms.MessageBox.Show("Error: " + ex.Message.ToString()
                                                   , "Error Message");
            }        
}      

Conclusion

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

References

  • MSDN

History

  • 23rd February, 2010: Initial post

License

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



Comments and Discussions

 
QuestionUrgent Pin
Kiran Wilson12-Aug-14 1:06
professionalKiran Wilson12-Aug-14 1:06 
GeneralRe: Urgent Pin
Md. Marufuzzaman12-Aug-14 5:34
professionalMd. Marufuzzaman12-Aug-14 5:34 
QuestionUrgent Pin
umeshfaq3-Oct-13 23:52
umeshfaq3-Oct-13 23:52 
AnswerRe: Urgent Pin
Md. Marufuzzaman12-Aug-14 5:38
professionalMd. Marufuzzaman12-Aug-14 5:38 
QuestionVisio custom menu event problem Pin
himanshub197813-Sep-13 0:58
himanshub197813-Sep-13 0:58 
QuestionCreating Secured Email Pin
JanieDsz26-Jun-13 6:42
JanieDsz26-Jun-13 6:42 
AnswerRe: Creating Secured Email Pin
Md. Marufuzzaman26-Jun-13 6:51
professionalMd. Marufuzzaman26-Jun-13 6:51 
QuestionHow to Create Form Regions using outlook 2003 add-in in vsto 2008 Pin
DEEPIKAP116-Jun-13 22:15
DEEPIKAP116-Jun-13 22:15 
QuestionNeed urgent help with commandbar combobox Pin
umeshfaq23-May-13 18:48
umeshfaq23-May-13 18:48 
AnswerRe: Need urgent help with commandbar combobox Pin
Md. Marufuzzaman24-May-13 7:55
professionalMd. Marufuzzaman24-May-13 7:55 
GeneralRe: Need urgent help with commandbar combobox Pin
umeshfaq26-May-13 18:25
umeshfaq26-May-13 18:25 
GeneralRe: Need urgent help with commandbar combobox Pin
umeshfaq30-May-13 19:50
umeshfaq30-May-13 19:50 
GeneralMy vote of 1 Pin
maddinthegreat11-Dec-12 13:42
maddinthegreat11-Dec-12 13:42 
GeneralRe: My vote of 1 Pin
Md. Marufuzzaman12-Dec-12 4:09
professionalMd. Marufuzzaman12-Dec-12 4:09 
GeneralRe: My vote of 1 Pin
Brisingr Aerowing24-Aug-13 13:21
professionalBrisingr Aerowing24-Aug-13 13:21 
GeneralMy vote of 3 Pin
Ingar Tødenes31-Oct-12 4:43
Ingar Tødenes31-Oct-12 4:43 
QuestionApplication for outlook ribbon Pin
Sid_ga23423-Oct-12 4:09
Sid_ga23423-Oct-12 4:09 
QuestionHi Pin
MP TP4-Apr-12 2:37
MP TP4-Apr-12 2:37 
AnswerRe: Hi Pin
Md. Marufuzzaman4-Apr-12 3:29
professionalMd. 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 Pin
taneem785130-Jan-12 6:52
taneem785130-Jan-12 6:52 
Questionoutlook 2010 addin Pin
rtalsaniya12-Dec-11 3:49
rtalsaniya12-Dec-11 3:49 
AnswerRe: outlook 2010 addin Pin
Md. Marufuzzaman12-Dec-11 4:24
professionalMd. Marufuzzaman12-Dec-11 4:24 
GeneralAdd HowTo put element in an existing menu Pin
serup9-Jun-11 20:25
serup9-Jun-11 20:25 
GeneralRe: Add HowTo put element in an existing menu Pin
Md. Marufuzzaman9-Jun-11 20:48
professionalMd. Marufuzzaman9-Jun-11 20:48 
GeneralRe: Add HowTo put element in an existing menu Pin
serup9-Jun-11 20:53
serup9-Jun-11 20:53 

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

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