How to: Change the Appearance of a Command

Artikel
07/31/2012

You can provide feedback to your user by changing the appearance of a command. For example, you may want a command to look different when it is unavailable. You can make commands available or unavailable, hide or show them, or check or uncheck them on the menu.

To change the appearance of a command, perform one of these actions:

Specify the appropriate flags in the command definition in the command table file.
Use the OleMenuCommandService service.
Implement the IOleCommandTarget interface and modify the raw command objects.

The following steps show how to find and update the appearance of a command by using the Managed Package Framework (MPF).

Follow the instructions in How to: Change the Text of a Menu Command to create a menu item named New Text.
In the VSPackage source file named, for example, MenuTextPackage.cs, add the following lines to the end of the MenuItemCallback method.
```
var command = sender as OleMenuCommand;
if (command.Text == "New Text") EnableMyCommand(command.CommandID.ID, false);
```

Obtain the command that you want to update from the OleMenuCommandService object and then set the appropriate properties on the command object. For example, the following method makes the specified command from a VSPackage command set available or unavailable.

<PrincipalPermission(SecurityAction.Demand)> _
Public Function EnableMyCommand(ByVal cmdID As Integer, ByVal fEnableCmd As Boolean) As Boolean
    Dim fCmdUpdated As Boolean = False
    Dim mcs As OleMenuCommandService = TryCast(Me.GetService(GetType(IMenuCommandService)), OleMenuCommandService)
    Dim newCmdID As CommandID = New CommandID(GuidList.guidMenuTextCmdSet, cmdID)
    Dim mc As MenuCommand = mcs.FindCommand(newCmdID)
    If mc IsNot Nothing Then
        mc.Enabled = fEnableCmd
        fCmdUpdated = True
    End If
    Return fCmdUpdated
End Function

[PrincipalPermission(SecurityAction.Demand)]
public bool EnableMyCommand(int cmdID, bool fEnableCmd)
{
    bool fCmdUpdated = false;
    var mcs = this.GetService(typeof(IMenuCommandService))
            as OleMenuCommandService;
    var newCmdID = new CommandID(GuidList.guidMenuTextCmdSet, cmdID);
    MenuCommand mc = mcs.FindCommand(newCmdID);
    if (mc != null)
    {
        mc.Enabled = fEnableCmd;
        fCmdUpdated = true;
    }
    return fCmdUpdated;
}

This makes the menu item named New Text unavailable after it has been clicked.

Freigeben über

How to: Change the Appearance of a Command

To change the appearance of a menu command

See Also

Concepts

Other Resources

Zusätzliche Ressourcen