1 out of 2 rated this helpful - Rate this topic

How to: Add and Handle Commands

Visual Studio 2010

The following objects allow you to create, handle, and manipulate commands on Visual Studio menus and toolbars.

Object Name	Description
IDTCommandTarget	Provides methods to determine the status of, or execute, a command added to the integrated development environment (IDE) by using the AddNamedCommand2 method.
Commands2	Represents all commands in the IDE.
Command	Represents a command in the IDE.
CommandEvents	Provides command events for add-ins.
CommandBarEvents	Provides a Click event for when a control on a command bar is clicked.

Note
If your command no longer appears on the appropriate command bar, or if you add a new command or modify an existing command, or if you would like to recreate the command, close all instances of Visual Studio and double-click the file named ReCreateCommands.reg in the folder containing the source code for your Add-in.

Using these objects, you can:

Add or remove a command bar in the Visual Studio IDE (AddCommandBar and RemoveCommandBar methods).
Add a new named command to a toolbar or menu (AddNamedCommand2 method).
Invoke a command or named command (Raise and Exec methods).
Obtain the status of a command (CommandInfo and QueryStatus methods).
Note
You cannot connect a CommandBarEvents event for CommandBar controls that were created for a new command added through AddNamedCommand2.

Note
You cannot connect a CommandBarEvents event for CommandBar controls that were created for a new command added through AddNamedCommand2.

Note
The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings or edition. These procedures were developed with the General Development Settings active. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see Visual Studio Settings.

Example

The following example uses:

The Command object.
The AddNamedCommand method.
The AddControl method.
The IDTCommandTarget interface.
The IDTCommandTarget.Exec method.
The IDTCommandTarget.QueryStatus method.

The procedure demonstrates how to make an add-in appear as a command on the Tools menu in Visual Studio. Add the first section of code to the OnConnection method of the add-in you create. In the Exec and QueryStatus methods, make sure that the line, If cmdName = "MyAddin1.Connect.MyAddin1" Then, reflects the name of your add-in.

public class Connect : Object, IDTExtensibility2, IDTCommandTarget
{
    public Connect()
    {
    }

public void OnConnection(object application, ext_ConnectMode 
  connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    if(connectMode == ext_ConnectMode.ext_cm_UISetup)
    {
        object []contextGUIDS = new object[] { };
        Commands2 commands = (Commands2)_applicationObject.Commands;
        string toolsMenuName;
        try
        {
            ResourceManager resourceManager = new
            ResourceManager("MyAddin4.CommandBar", 
            Assembly.GetExecutingAssembly());
            CultureInfo cultureInfo = new 
              System.Globalization.CultureInfo
             (_applicationObject.LocaleID);
            string resourceName =  
            String.Concat(cultureInfo.TwoLetterISOLanguageName, 
              "Tools");
            toolsMenuName = resourceManager.GetString(resourceName);
        }
        catch
        {
            toolsMenuName = "Tools";
        }

        CommandBar menuBarCommandBar = 
            ((CommandBars)_applicationObject.CommandBars)["MenuBar"];
        CommandBarControl toolsControl = 
          menuBarCommandBar.Controls[toolsMenuName];
        CommandBarPopup toolsPopup = (CommandBarPopup)toolsControl;
        try
        {
            Command command = commands.AddNamedCommand2(_addInInstance, 
              "MyAddin4", "MyAddin4", "Executes the command for 
              MyAddin4", true, 59, ref contextGUIDS, 
              (int)vsCommandStatus.vsCommandStatusSupported+
              (int)vsCommandStatus.vsCommandStatusEnabled, 
              (int)vsCommandStyle.vsCommandStylePictAndText,  
              vsCommandControlType.vsCommandControlTypeButton);

            if((command != null) && (toolsPopup != null))
            {
                command.AddControl(toolsPopup.CommandBar, 1);
            }
        }
        catch(System.ArgumentException)
        {
        }
    }
}

public void QueryStatus(string commandName, vsCommandStatusTextWanted 
  neededText, ref vsCommandStatus status, ref object commandText)
{
    if(neededText == 
      vsCommandStatusTextWanted.vsCommandStatusTextWantedNone)
    {
        if(commandName == "MyAddin4.Connect.MyAddin4")
        {
            status = (vsCommandStatus)vsCommandStatus.
              vsCommandStatusSupported|vsCommandStatus.
              vsCommandStatusEnabled;
            return;
        }
    }
}

public void Exec(string commandName, vsCommandExecOption executeOption, 
  ref object varIn, ref object varOut, ref bool handled)
{
    handled = false;
    if(executeOption == 
      vsCommandExecOption.vsCommandExecOptionDoDefault)
    {
        if(commandName == "MyAddin4.Connect.MyAddin4")
        {
            handled = true;
            return;
        }
    }
}

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD

How to: Add and Handle Commands

Tasks

Concepts

Other Resources

Community Additions