Compartilhar via

Adicionar um atalho de chave de acesso a um controle

Uma chave de acesso é um caractere sublinhado no texto de um menu, item de menu ou rótulo de um controle, como um botão. Com uma chave de acesso, o usuário pode interagir com o controle pressionando a tecla Alt em combinação com a chave de acesso predefinida. Por exemplo, se um botão executa um procedimento de impressão de formulário e, portanto, sua propriedade for definida como "Imprimir", adicionar o símbolo '&' (&) antes da letra "P" faz com que a letra "P" seja sublinhada no texto do botão em tempo de execução. O usuário pode executar o comando associado ao botão pressionando a combinação de teclas Alt + P .

Controles que não podem receber foco não podem ter chaves de acesso, exceto controles de rótulo. Para obter mais informações, consulte Usar um rótulo para concentrar um controle.

Dica

A tecla de acesso pode não estar visível no controle até que a Alt seja pressionada.

Desenhista

Na janela Propriedades do Visual Studio, defina a propriedade Text como uma cadeia de caracteres que inclua o símbolo '&' (&) antes da letra que será a chave de acesso. Por exemplo, para definir a letra "P" como a chave de acesso, insira &Imprimir.

Caixa de diálogo de Propriedades Caixa de diálogo Propriedades com a propriedade de texto selecionada e a chave de acesso

Programático

Defina a propriedade Text como uma cadeia de caracteres que inclui um símbolo de e comercial (&) antes da letra que será o atalho.

' Set the letter "P" as an access key.
Button1.Text = "&Print"

// Set the letter "P" as an access key.
button1.Text = "&Print";

Usar um rótulo para direcionar o foco de um controle

Mesmo que um rótulo não possa ser focado, ele tem a capacidade de concentrar o próximo controle na ordem de tabulação do formulário. Cada controle recebe um valor à propriedade TabIndex, geralmente em ordem sequencial crescente. Quando a chave de acesso é atribuída à propriedade Label.Text, o próximo controle na ordem de tabulação sequencial é focado.

Usando o exemplo da seção Programática, se o botão não tivesse nenhum texto definido, mas sim apresentasse uma imagem de uma impressora, você poderia usar um rótulo para focar no botão.

// Set the letter "P" as an access key.
label1.Text = "&Print";
label1.TabIndex = 9
button1.TabIndex = 10

' Set the letter "P" as an access key.
Label1.Text = "&Print"
Label1.TabIndex = 9
Button1.TabIndex = 10

Exibir um E comercial

Ao definir o texto ou a legenda de um controle que interpreta um E comercial (&) como uma tecla de acesso, use dois Es comerciais consecutivos (&&) para exibir apenas um E comercial. Por exemplo, o texto de um botão definido como "&Print && Close" é exibido na legenda de Print & Close:

// Set the letter "P" as an access key.
button1.Text = "&Print && Close";

' Set the letter "P" as an access key.
Button1.Text = "&Print && Close"

exibindo uma E comercial em um botão

Consulte também