Recurso ACCELERATORS
Define um ou mais aceleradores para um aplicativo. Um acelerador é um pressionamento de tecla definido pelo aplicativo para dar ao usuário uma maneira rápida de executar uma tarefa.
acctablename ACCELERATORS [optional-statements] {event, idvalue, [type] [options]... }
Parâmetros
-
acctablename
-
Nome exclusivo ou um valor inteiro sem sinal de 16 bits que identifica o recurso.
-
instruções opcionais
-
Zero ou mais das instruções a seguir.
Instrução Descrição Palavra dwordCHARACTERISTICS Informações definidas pelo usuário sobre um recurso que pode ser usado por ferramentas que leem e gravam arquivos de recursos. Para obter mais informações, consulte CARACTERÍSTICAS. Linguagem LANGUAGE, sublanguage Especifica o idioma do recurso. Para obter mais informações, consulte LANGUAGE. VERSIONdword Número de versão definido pelo usuário para o recurso que pode ser usado por ferramentas que leem e gravam arquivos de recursos. Para obter mais informações, consulte VERSION. -
Evento
-
Pressionamento de tecla a ser usado como acelerador. Pode ser qualquer um dos seguintes tipos de caracteres.
Tipo Descrição "char" Um único caractere entre aspas duplas ("). O caractere pode ser precedido por um cursor (^), o que significa que o caractere é um caractere de controle. Caractere Um valor inteiro que representa um caractere. O parâmetro de tipo deve ser ASCII. caractere de chave virtual Um valor inteiro que representa uma chave virtual. A chave virtual para chaves alfanuméricas pode ser especificada colocando a letra maiúscula ou o número entre aspas duplas (por exemplo, "9" ou "C"). O parâmetro de tipo deve ser VIRTKEY. -
Idvalue
-
um valor inteiro sem sinal de 16 bits que identifica o acelerador.
-
Tipo
-
Necessário somente quando o parâmetro de evento é um caractere ou um caractere de chave virtual. O parâmetro de tipo especifica ASCII ou VIRTKEY; o valor inteiro do evento é interpretado adequadamente. Quando VIRTKEY é especificado e o evento contém uma cadeia de caracteres, o evento deve ser maiúsculo.
-
Opções
-
opções que definem o acelerador. Esse parâmetro pode usar um dos valores a seguir.
Opção Descrição NOINVERT Especifica que nenhum item de menu de nível superior é realçado quando o acelerador é usado. Isso é útil ao definir aceleradores para ações como rolagem que não correspondem a um item de menu. Se NOINVERT for omitido, um item de menu de nível superior será realçado (se possível) quando o acelerador for usado. Esse atributo é obsoleto e retido apenas para compatibilidade com versões anteriores com arquivos de recurso projetados para o Windows de 16 bits. ALT Faz com que o acelerador seja ativado somente se a tecla ALT estiver inativa. Aplica-se somente a chaves virtuais. SHIFT Faz com que o acelerador seja ativado somente se a tecla SHIFT estiver inativa. Aplica-se somente a chaves virtuais CONTROLE Define o caractere como um caractere de controle (o acelerador só será ativado se a tecla CONTROL estiver inativa). Isso tem o mesmo efeito que usar um cursor (^) antes do caractere acelerador no parâmetro de evento . Aplica-se somente a chaves virtuais
Determinados atributos também têm suporte para compatibilidade com versões anteriores. Para obter mais informações, consulte Atributos comuns de recurso.
Comentários
A função TranslateAccelerator é usada para converter mensagens de acelerador da fila do aplicativo em mensagens WM_COMMAND ou WM_SYSCOMMAND .
Exemplos
O exemplo a seguir demonstra o uso de teclas de acelerador.
1 ACCELERATORS
{
"^C", IDDCLEAR ; control C
"K", IDDCLEAR ; shift K
"k", IDDELLIPSE, ALT ; alt k
98, IDDRECT, ASCII ; b
66, IDDSTAR, ASCII ; B (shift b)
"g", IDDRECT ; g
"G", IDDSTAR ; G (shift G)
VK_F1, IDDCLEAR, VIRTKEY ; F1
VK_F1, IDDSTAR, CONTROL, VIRTKEY ; control F1
VK_F1, IDDELLIPSE, SHIFT, VIRTKEY ; shift F1
VK_F1, IDDRECT, ALT, VIRTKEY ; alt F1
VK_F2, IDDCLEAR, ALT, SHIFT, VIRTKEY ; alt shift F2
VK_F2, IDDSTAR, CONTROL, SHIFT, VIRTKEY ; ctrl shift F2
VK_F2, IDDRECT, ALT, CONTROL, VIRTKEY ; alt control F2
}
Confira também