Recurso ACCELERATORS

Artículo
06/13/2023

Define uno o varios aceleradores para una aplicación. Un acelerador es una pulsación de tecla definida por la aplicación para proporcionar al usuario una forma rápida de realizar una tarea.

acctablename ACCELERATORS [optional-statements] {event, idvalue, [type] [options]... }

Parámetros

acctablename

Nombre único o un valor entero de 16 bits sin signo que identifica el recurso.

instrucciones opcionales

Cero o más de las siguientes instrucciones.

.	Descripción
CARACTERÍSTICASdword	Información definida por el usuario sobre un recurso que pueden usar las herramientas que leen y escriben archivos de recursos. Para obtener más información, vea CARACTERÍSTICAS.
IDIOMA,sublanguaje	Especifica el idioma del recurso. Para obtener más información, vea LANGUAGE.
VERSIONdword	Número de versión definido por el usuario para el recurso que pueden usar las herramientas que leen y escriben archivos de recursos. Para obtener más información, vea VERSION.

Evento

Pulsación de tecla que se va a usar como acelerador. Puede ser cualquiera de los siguientes tipos de caracteres.

Tipo	Descripción
"char"	Un carácter individual entre comillas dobles ("). El carácter puede ir precedido de un símbolo de intercalación (^), lo que significa que el carácter es un carácter de control.
Carácter	Valor entero que representa un carácter. El parámetro de tipo debe ser ASCII.
Carácter de clave virtual	Valor entero que representa una clave virtual. La clave virtual para las claves alfanuméricas se puede especificar colocando la letra o el número en mayúsculas entre comillas dobles (por ejemplo, "9" o "C"). El parámetro type debe ser VIRTKEY.

idvalue

un valor entero de 16 bits sin signo que identifica el acelerador.

Tipo

Solo se requiere cuando el parámetro de evento es un carácter o un carácter de clave virtual. El parámetro type especifica ASCII o VIRTKEY; El valor entero del evento se interpreta en consecuencia. Cuando se especifica VIRTKEY y el evento contiene una cadena, el evento debe estar en mayúsculas.

Opciones

opciones que definen el acelerador. Este parámetro puede ser uno o más de los siguientes valores.

Opción	Descripción
NOINVERT	Especifica que no se resalta ningún elemento de menú de nivel superior cuando se usa el acelerador. Esto resulta útil al definir aceleradores para acciones como el desplazamiento que no se corresponde con un elemento de menú. Si NOINVERT se omite, se resaltará un elemento de menú de nivel superior (si es posible) cuando se use el acelerador. Este atributo está obsoleto y solo se conserva para la compatibilidad con versiones anteriores con archivos de recursos diseñados para Windows de 16 bits.
ALT	Hace que el acelerador se active solo si la tecla ALT está inactiva. Solo se aplica a las claves virtuales.
CAMBIO	Hace que el acelerador se active solo si la tecla MAYÚS está inactiva. Solo se aplica a las claves virtuales.
CONTROL	Define el carácter como un carácter de control (el acelerador solo se activa si la tecla CONTROL está inactiva). Esto tiene el mismo efecto que usar un símbolo de intercalación (^) antes del carácter de acelerador en el parámetro de evento . Solo se aplica a las claves virtuales.

Algunos atributos también se admiten para la compatibilidad con versiones anteriores. Para obtener más información, consulte Atributos de recursos comunes.

Observaciones

La función TranslateAccelerator se usa para traducir mensajes aceleradores de la cola de aplicaciones en WM_COMMAND o WM_SYSCOMMAND mensajes.

Ejemplos

En el ejemplo siguiente se muestra el uso de teclas de aceleración.

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
}

Consulte también

Uso de los aceleradores de teclado
TranslateAccelerator
CARACTERÍSTICAS
DIÁLOGO
LENGUA
MENÚ
RCDATA
STRINGTABLE
VERSIÓN

Share via