Compartilhar via


Como associar um comando a uma única tecla de atalho

Os suplementos do Visual Studio foram substituídos no Visual Studio 2013. Você deve atualizar seus suplementos para as extensões VSPackage. Para obter mais informações sobre atualização, consulte Perguntas frequentes: convertendo suplementos em extensões VSPackage.

Além de exibir as associações de tecla de atalho, você também pode usar a propriedade de Bindings para definir ou alterar as associações principais para um comando do Visual Studio. Observe que quando você altera uma associação principal, ela substitui a associação chave anterior (a associação antiga será perdida.) Além disso, se a nova associação de chave for usada por outro comando, a associação de chave também será removida do comando antigo e atribuída novamente ao novo comando.

No entanto, há uma maneira de preservar uma associação de tecla, de modo que uma nova associação de tecla se torne uma tecla de atalho adicional, em vez de substituir a antiga. Esse método é descrito neste tópico, Como preservar os atalhos de teclado existentes.

Dica

As caixas de diálogo e os comandos de menu que você vê podem diferir das descritas no Help dependendo de suas configurações ativas ou de edição.Esses procedimentos foram desenvolvidos com as Configurações Gerais de Desenvolvimento ativas.Para alterar as configurações, escolha Importar e ExportarConfigurações no menu de Ferramentas.Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Procedimento

Para associar um comando a uma tecla de atalho

  1. Use o Assistente do suplemento do Visual Studio para criar um novo suplemento. Nomeie o projeto e clique em OK para iniciar o assistente.

    Para obter mais informações sobre como usar o Assistente de Suplemento do Visual Studio, consulte Como criar um suplemento.

  2. Na página Selecione uma Linguagem de Programação, selecione Criar um Suplemento usando o Visual C# para executar o exemplo do Visual C# abaixo ou Criar um Suplemento Usando o Visual Basic para executar o exemplo do Visual Basic.

  3. Cole a função de exemplo abaixo na classe Connect do código gerado pelo Assistente de suplemento do Visual Studio.

  4. Método deOnConnection como descrito em Como compilar e executar os exemplos de código do modelo de objeto Automation.

  5. Compile e execute o suplemento.

    Pressione F2 para executar o comando File.Newfile

Exemplo

O exemplo de suplemento a seguir demonstra como associar o comando File.NewFile a uma única tecla de atalho (F2).

Public Sub OnConnection(ByVal application As Object, ByVal  _
  connectMode As ext_ConnectMode, ByVal addInInst As Object, ByRef  _
  custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    BindingsExample(_applicationObject)
            
End Sub

Sub BindingsExample(ByVal dte As DTE2)
    Dim cmds As Commands
    Dim cmd As Command
    Try
        ' Set references to the Commands collection and the 
        ' File.NewFile command.
        cmds = DTE.Commands
        cmd = cmds.Item("File.NewFile")

        ' Assigns the command (File.NewFile) globally to the F2 key.
        cmd.Bindings = "Global::F2"
        MsgBox("key remapped")
    Catch ex As Exception
        MsgBox(ex.ToString)
    End Try
End Sub
public void OnConnection(object application, ext_ConnectMode 
connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    BindingsExample(_applicationObject);

}

public void BindingsExample(DTE2 dte)
{
    Commands cmds;
    Command cmd;

    try
    {
        // Set references to the Commands collection and the 
        // File.NewFile command.
        cmds = dte.Commands;
        cmd = cmds.Item("File.NewFile", 1);

        // Assigns the command (File.NewFile) globally to the F2 key.
        cmd.Bindings = "Global::F2";
        System.Windows.Forms.MessageBox.Show("key remapped");
    }
    catch (Exception ex)
    {
        System.Windows.Forms.MessageBox.Show(ex.Message);
    }
}

Consulte também

Tarefas

Como associar um comando a vários atalhos de teclado

Como preservar os atalhos de teclado existentes

Conceitos

Formato dos parâmetros da propriedade Bindings

Outros recursos

Associando comandos de suplementos a teclas