Compartilhar via


Propriedade KeyboardShortcut

A propriedade KeyboardShortcut descreve uma combinação de teclas ou teclas que ativa um objeto acessível especificado.

A propriedade KeyboardShortcut é recuperada chamando IAccessible::get_accKeyboardShortcut.

A cadeia de caracteres recuperada descreve uma tecla de atalho (também chamada de acelerador de teclado) ou uma tecla de acesso (também chamada de mnemônica). Uma tecla de acesso é um caractere sublinhado no texto de um menu, item de menu ou rótulo de um controle, como um botão de push.

A cadeia de caracteres recuperada deve conter o nome da chave junto com a chave modificadora ou as chaves. A cadeia de caracteres deve estar no seguinte formato para que os clientes possam analisá-la facilmente: [[chave modificadora]+[...] +] nome da chave.

Os exemplos incluem ALT+F, CTRL+ALT+4, WIN+F1, CTRL+ALT+SHIFT+BACKSPACE ou simplesmente BACKSPACE.

A tabela a seguir lista as chaves modificadoras.

Tecla modificadora Descrição
ALT Chave modificadora alternativa
CTRL Chave modificadora de controle
SHIFT Tecla modificadora shift
GANHAR Tecla de logotipo do Windows
FN Chave de função em computadores portáteis

 

Não localize cadeias de caracteres de atalho de teclado.

Manipulando objetos que têm ambos os tipos de chave

Se um objeto tiver uma tecla de atalho e uma tecla de acesso, a propriedade KeyboardShortcut retornará a tecla de acesso. A tecla de acesso é aquela que um usuário pressionaria quando o objeto ou o pai do objeto tiver o foco do teclado. Por exemplo, o item de menu Imprimir pode ter uma tecla de atalho (CTRL+P) e uma tecla de acesso (P). Se um usuário pressionar CTRL+P enquanto o menu estiver ativo, nada acontecerá. Mas se um usuário pressionar P enquanto o menu estiver ativo, ele invocará a caixa de diálogo Imprimir do aplicativo. Nesse caso, a propriedade KeyboardShortcut é "P" para refletir o que o usuário deve pressionar quando o menu tem o foco do teclado.