Formato dos parâmetros da propriedade Bindings

Artigo
06/10/2015

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.

A propriedade Bindings tem um formato de parâmetro específico que você deve seguir, ou um erro será exibido. Veja a seguir os parâmetros necessários.

Parâmetros da propriedade associações

O formato do parâmetro é: Scope::ModifierKeys1+Key1,ModifierKeys2+Key2.

A seguir encontram-se duas associações de teclas que se aplicam a um comando no escopo global. Essas associações de tecla são Ctrl-Shift-D seguidas pela tecla O e Ctrl-Shift-D seguidas pela tecla F: Global::Ctrl+Shift+D,O,Ctrl+Shift+D,F.

Nesse caso, as teclas modificadoras e os valores da chave são:

Parâmetro	Valor
Scope	Global
ModifierKeys1	Ctrl+Shift+D
Key1	O
ModifierKeys2	Ctrl+Shift+D
Key2	F

Se você estiver usando Visual Studio com as configurações padrão, então a tecla de atalho atribuída para o comando de File.NewFile é Global::Ctrl+N. Isso significa que pressionar e manter CTRL enquanto pressiona N exibe a caixa de diálogo Novo Arquivo. A palavra-chave Global significa que o comando funciona em todas as áreas do Visual Studio.

Escopo

O parâmetro Scope indica o contexto no qual a tecla de atalho funciona. A palavra-chave Global define que ela funciona em qualquer lugar do Visual Studio, enquanto um escopo específico define que ela funciona somente nesse escopo. Global é escopo mais usado. Os valores disponíveis para Scope dependem do pacote.

Por exemplo, CTRL+B coloca o texto selecionado em negrito quando ele estiver no editor HTML, mas a mesma combinação de teclas exibe a caixa de diálogo Pontos de interrupção se o editor estiver inativo. Se você fosse aplicar um escopo global a essa combinação de teclas de atalho, então CTRL+B funcionaria (ou tentaria funcionar) em qualquer lugar no Visual Studio, em vez de apenas no editor de HTML.

Independentemente do escopo que você usar, é necessário que ele venha seguido de dois pontos (::) antes de especificar os outros parâmetros.

Teclas1 modificadoras

As teclas modificadoras são as chaves de sistema que você pressiona ao pressionar outra tecla. As teclas modificadoras disponíveis são CTRL, SHIFT e ALT. Você pode combinar mais de uma tecla modificadora separando-as com um sinal +. Por exemplo: CTRL+ALT+X ou SHIFT+ALT+Y. Você pode especificar várias letras, como CTRL+ALT+Y, N, que significa que you press CTRL+ALT+Y e, depois, a tecla N.

Key1

Uma chave é qualquer chave em um teclado de 102 teclas padrão. As teclas excluídas nos teclados mais recentes são: a tecla Windows, teclas de multimídia (como os favoritos, volume, parar, etc.), e a tecla Fn em alguns laptops. As chaves diferentes das chaves padrão de letra e número são conhecidas como chaves virtuais. A tabela a seguir lista todas as teclas virtuais que a propriedade Bindings aceita. Qualquer chave virtual que não esteja nesta lista será ignorada.

VOLTAR	DELETE	INSERIR	ESPAÇO	F1
F2	F3	F4	F5	F6
F7	F8	F9	F10	F11
F12	F13	F14	F15	F16
F17	F18	F19	F20	F21
F22	F23	F24	RETORNAR	CANCELAR
PARA CIMA	PARA BAIXO	ESQUERDA	DIREITA	TAB
INÍCIO	FINALIZAR	ANTERIOR	AVANÇAR	ESCAPE
DECIMAL	MULTIPLICAR	SUBTRAIR	ADICIONAR	DIVIDIR
NUMPAD0	NUMPAD1	NUMPAD2	NUMPAD3	NUMPAD4
NUMPAD5	NUMPAD6	NUMPAD7	NUMPAD8	NUMPAD9

Modificador Keys2 e Key2

Essas teclas adicionais opcionais permitem que você expanda os grupos de comando e evitam colisões de tecla de atalho. Por exemplo, você pode atribuir CTRL+SHIFT+D, O para abrir um arquivo no editor do arquivo, e atribuir CTRL+SHIFT+D, S para salvar o arquivo. Além disso, isso permite o agrupamento de comandos semelhantes no mesmo atalho de teclado para maior facilidade de uso e memorização. Também impede de usar todas as teclas de atalho mais curtas disponíveis que são frequentemente usadas por outros comandos.