Mensaje WM_SETHOTKEY
Definición
WM_SETHOTKEY wParam = (WPARAM) MAKEWORD(vkey, modifiers) // código de tecla virtual y modificadores de hot key lParam = 0; // no usado; debe ser cero
Una aplicación envía un mensaje WM_SETHOTKEY a una ventana para asociar una hot key con una ventana. Cuando el usuario presiona la hot key, el sistema activa la ventana.
Descripción
vkey: valor de wParam. Especifica el código de tecla virtual y modidicadores de la hot key a asociar con la ventana. El código de tecla virtual está en el byte de menor peso del parámetro y las banderas del modificador en el byte de mayor peso. Asignando este parámetro a NULL se elimina la asociación de la hot key con la ventana. El byte modificador puede ser una combinación de las siguientes banderas:
| Valor | Significado |
|---|---|
| HOTKEYF_ALT | tecla ALT |
| HOTKEYF_CONTROL | Tecla CTRL |
| HOTKEYF_EXT | Tecla extendida |
| HOTKEYF_SHIFT | Tecla SHIFT |
Valor de retorno
El valor de retorno es uno de los siguientes:
| Valor | Significado |
|---|---|
| -1 | La función fracasó, el hot key es inválido. |
| 0 | La función fracasó, la ventana es inválida. |
| 1 | La función tuvo éxito, y ninguna otra ventana tiene la misma hot key. |
| 2 | La función tuvo éxito, pero otra ventana ya tenía la misma hot key. |
Observaciones
Una hot key no puede asociarse con una ventana hija.
VK_ESCAPE, VK_SPACE y VK_TAB son hot keys inválidas.
Cuando el usuario presiona la hot key, el sistema genera un mensaje WM_SYSCOMMAND con wParam igual al valor SC_HOTKEY.
Una ventana sólo puede tener una hot key. Si la ventana ya tiene una hot key asociada con ella, la nueva hot key reemplaza a la vieja. Si más de una ventana tiene la misma hot key, la ventana que se activará por la hot key es aleatoria.
Estas hot keys no están relacionadas con las asignadas por la función RegisterHotKey.