Compartilhar via


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

Como usar aceleradores de teclado

TranslateAccelerator

CARACTERÍSTICAS

DIÁLOGO

LÍNGUA

MENU

RCDATA

STRINGTABLE

VERSÃO