Editor de aceleradores (C++)

Una tabla de aceleradores es un recurso de Windows para C++ que contiene una lista de teclas de aceleración (también conocidas como teclas de método abreviado) y los identificadores de comandos asociados con ellas. Un programa puede tener más de una tabla de aceleradores.

Normalmente, los aceleradores se usan como métodos abreviados de teclado para comandos de programa que también están disponibles en un menú o una barra de herramientas. Sin embargo, puede usar la tabla de aceleradores para definir las combinaciones de teclas para los comandos que no tienen asociado un objeto de interfaz de usuario.

Sugerencia

Al usar el Editor de aceleradores, puede hacer clic con el botón derecho para mostrar un menú contextual de los comandos usados con mayor frecuencia. Los comandos disponibles dependen del objeto al que apunta el puntero.

Puede usar la Vista de clases para enlazar comandos de teclas de aceleración al código. Para ver una lista de las teclas de aceleración predefinidas, consulte Teclas de aceleración.

Nota:

Windows no permite crear tablas de aceleradores vacías. Si crea una tabla de aceleradores sin entradas, se elimina automáticamente al guardar la tabla.

Propiedades de acelerador

Puede establecer propiedades de acelerador en la ventana Propiedades en cualquier momento. También puede usar el Editor de aceleradores para modificar las propiedades de los aceleradores de la tabla de aceleradores. Los cambios realizados mediante la ventana Propiedades o el Editor de aceleradores tienen el mismo resultado: las modificaciones se reflejan inmediatamente en la tabla de aceleradores.

La propiedad ID hace referencia a cada entrada de tabla de aceleradores en el código del programa. Esta entrada es el valor de comando que recibe el programa cuando un usuario presiona la tecla de aceleración o una combinación de teclas. Para que un acelerador sea igual que un elemento de menú, haga que la propiedad ID sea la misma, siempre y cuando el valor de ID de la tabla de aceleradores sea el mismo que el valor de ID del recurso de menú.

El ID de cada acelerador tiene tres propiedades: Modifier, Key y Type

La propiedad Modifier establece combinaciones de teclas de control para el acelerador.

Nota:

En la ventana Propiedades, la propiedad Modifier aparece como tres propiedades booleanas distintas, que se pueden controlar independientemente: Alt, Ctrl y Mayús.

A continuación, se muestran entradas válidas para la propiedad Modifier en la tabla de aceleradores:

Valor	Descripción
None	El usuario solo presiona el valor Key. Este valor se usa de forma más eficaz con los valores ASCII/ANSI de 001 a 026, que se interpreta como de la ^A a la ^Z (Ctrl+A a Ctrl+Z).
Alt	El usuario debe presionar Alt antes del valor Key.
Ctrl	El usuario debe presionar Ctrl antes del valor Key; no es válido con el tipo ASCII.
Shift	El usuario debe presionar Mayús antes del valor Key.
Ctrl+Alt	El usuario debe presionar Ctrl y Alt ates del valor Key; no es válido con el tipo ASCII.
Ctrl+Mayús	El usuario debe presionar Ctrl y Mayús antes del valor Key, no es válido con el tipo ASCII.
Alt+Mayús	El usuario debe presionar Alt y Mayús antes del valor Key; no es válido con el tipo ASCII.
Ctrl+Alt+Mayús	El usuario debe presionar Ctrl, Alt y Mayús antes del valor Key; no es válido con el tipo ASCII.

La propiedad Key establece la tecla real que se usará como acelerador.

A continuación se muestran entradas válidas para la propiedad Key de la tabla de aceleradores:

Valor	Descripción
Entero entre 0 y 255 en formato decimal.	El valor determina si el valor se trata como ASCII o ANSI de la siguiente manera: - Los números de un solo dígito siempre se interpretan como la tecla correspondiente, en lugar de como valores ASCII o ANSI. - Los valores comprendidos entre 1 y 26, cuando van precedidos de ceros, se interpretan como de la ^A a la ^Z, que representa el valor ASCII de las letras del alfabeto cuando se presiona con la tecla Ctrl y se mantiene presionada. - Los valores comprendidos entre 27 y 32 siempre se interpretan como valores decimales de tres dígitos, de 027 a 032. - Los valores comprendidos entre 033 y 255, tanto si van precedidos por 0 como si no, se interpretan como valores ANSI.
Un solo carácter de teclado.	Las mayúsculas A- Z o los números 0 - 9 pueden ser valores de tecla ASCII o virtuales. Cualquier otro carácter es solo ASCII.
Un solo carácter de teclado en el intervalo A - Z (solo en mayúsculas), precedido por un símbolo de intercalación (^), por ejemplo, ^C.	Esta opción escribe el valor ASCII de la tecla cuando se presiona con la tecla Ctrl y se mantiene presionada.
Cualquier identificador de tecla virtual válido.	El cuadro desplegable Tecla de la tabla de aceleradores contiene una lista de identificadores de tecla virtual estándar.

Nota:

Al escribir un valor ASCII, las opciones de la propiedad Modifier son limitadas. La única tecla de control disponible para su uso es la tecla Alt.

Sugerencia

Un método abreviado de teclado para definir una tecla aceleradora consiste en hacer clic con el botón derecho en una o varias entradas de la tabla de aceleradores y, luego, elegir Tecla siguiente y presionar cualquiera de las teclas o combinaciones de teclas del teclado.

Este comando Tecla siguiente también está disponible en el menú Editar.

La propiedad Type determina si la combinación de teclas de método abreviado asociada al ID del acelerador se interpreta como un valor de tecla ASCII/ANSI o una combinación de teclas virtuales (VIRTKEY).

• Si la propiedad Type es ASCII, la propiedad Modifier solo puede ser None o Alt, o puede tener un acelerador que use la tecla Ctrl, como se especifica anteponiendo ^ a la tecla.

• Si la propiedad Type es VIRTKEY, cualquier combinación de valores de Modifier y Key es válida.

Nota:

Si quiere escribir un valor en la tabla de aceleradores y que el valor se trate como ASCII/ANSI, seleccione el valor de Tipo de la entrada de la tabla y elija ASCII en la lista desplegable. Sin embargo, si usa el comando Siguiente Clave Tecleada del menú Editar para especificar la Clave, debe cambiar la propiedad Tipo de VIRTKEY a ASCII antes de introducir el código de la Clave.

Tablas de aceleradores

En un proyecto de C++, puede editar una tabla de aceleradores directamente con la edición en contexto del Editor del aceleradores.

Los procedimientos siguientes hacen referencia al uso de páginas de propiedades estándar; sin embargo, tanto la edición en contexto como el método de la página de propiedades tienen el mismo resultado. Los cambios realizados mediante páginas de propiedades o mediante la edición en contexto se reflejan inmediatamente en la tabla de aceleradores.

Para editar el contenido de una tabla de aceleradores

1. Para abrir la tabla de aceleradores, haga doble clic en su icono en Vista de recursos.

2. Seleccione una entrada de la tabla y elija activar la edición en contexto.

3. Haga su selección en el cuadro combinado desplegable o escriba para realizar cambios:

   • Para ID, seleccione un valor de la lista o escriba para editar.

   • Para Modifier, seleccione un valor de la lista.

   • Para Key, seleccione un valor de la lista o escriba para editar.

   • Para Type, seleccione ASCII o VIRTKEY en la lista.

Para buscar una entrada en una tabla de aceleradores abierta:

1. Para abrir la tabla de aceleradores, haga doble clic en su icono en Vista de recursos.

2. Seleccione un encabezado de columna para ordenar alfabéticamente su contenido. Por ejemplo, seleccione ID para mostrar todos los identificadores de la tabla de aceleradores en orden alfabético.

   A continuación, puede examinar la lista y buscar la entrada.

Para agregar una entrada a una tabla de aceleradores

1. Para abrir la tabla de aceleradores, haga doble clic en su icono en Vista de recursos.

2. Haga clic con el botón derecho en la tabla de aceleradores y elija Nuevo acelerador, o seleccione la entrada de fila vacía en la parte inferior de la tabla.

3. Seleccione un identificador en la lista desplegable del cuadro Id. o escriba un nuevo identificador en el cuadro Id.

4. Escriba la tecla que quiere usar como acelerador o haga clic con el botón derecho y elija Tecla siguiente para establecer una combinación de teclas o vaya al menú Editar>Tecla siguiente.

5. Cambie las propiedades Modifier y Type, si es necesario, y presione Entrar.

Nota:

Asegúrese de que todos los aceleradores que defina sean únicos. Puede asignar varias combinaciones de teclas al mismo identificador sin que se produzcan efectos negativos; por ejemplo, Ctrl+P y F8 pueden asignarse a ID_PRINT. Sin embargo, asignar una combinación de teclas a más de un identificador no funcionará bien; por ejemplo, asignar Ctrl+Z tanto a ID_SPELL_CHECK como a ID_THESAURUS.

Para eliminar una entrada de una tabla de aceleradores

1. Para abrir la tabla de aceleradores, haga doble clic en su icono en Vista de recursos.

2. Seleccione la entrada que quiere eliminar o mantenga presionada la tecla Ctrl o Mayús mientras selecciona varias entradas.

3. Haga clic con el botón derecho y elija Eliminar o vaya al menú Editar>Eliminar.

Sugerencia

También puede presionar la tecla Eliminar para eliminar.

Para mover o copiar una entrada de una tabla de aceleradores a otro archivo de script de recursos

1. Abra las tablas de aceleradores en ambos archivos de script de recursos y seleccione la entrada que quiere mover.

2. En el menú Editar, elija Copiar o Cortar.

3. Seleccione una entrada en el archivo de script de recursos de destino y, en el menú Editar, elija Pegar.

Nota:

También puede usar las teclas de método abreviado para copiar y pegar.

Para cambiar las propiedades de varias teclas aceleradores, haga lo siguiente:

1. Para abrir la tabla de aceleradores, haga doble clic en su icono en Vista de recursos.

2. Seleccione las teclas aceleradoras que quiere cambiar; para ello, mantenga presionada la tecla Ctrl mientras selecciona cada una.

3. Vaya a la ventana Propiedades y escriba los valores que quiera que compartan todos los aceleradores seleccionados.

Nota:

Cada valor de modificador aparece como una propiedad booleana en la ventana Propiedades. Si cambia un valor de modificador en la ventana Propiedades, la tabla de aceleradores trata el nuevo modificador como una adición a los modificadores que estaban allí anteriormente. Por este motivo, si establece valores de modificador, deberá establecer todos ellos para asegurarse de que cada acelerador comparte la misma configuración de Modifier.

Requisitos

Win32

Consulte también

Resource Editors
Teclas de aceleración