Compartir a través de


mensaje de WM_SETHOTKEY

Se envía a una ventana para asociar una clave activa a la ventana. Cuando el usuario presiona la tecla activa, el sistema activa la ventana.

#define WM_SETHOTKEY                    0x0032

Parámetros

wParam

El byte bajo de la palabra de orden bajo especifica el código de clave virtual que se va a asociar a la ventana.

El byte alto de la palabra de orden bajo puede ser uno o varios de los siguientes valores de CommCtrl.h.

Importancia Significado
HOTKEYF_ALT
0x04
Tecla ALT
HOTKEYF_CONTROL
0x02
Tecla CTRL
HOTKEYF_EXT
0x08
Clave extendida
HOTKEYF_SHIFT
0x01
Tecla de mayúsculas

Se omite la palabra de orden superior de wParam .

Al establecer wParam en NULL , se quita la clave activa asociada a una ventana.

lParam

Este parámetro no se usa.

Valor devuelto

El valor devuelto es uno de los siguientes.

Valor devuelto Descripción
-1
La función no es correcta; la clave activa no es válida.
0
La función no es correcta; la ventana no es válida.
1
La función se realiza correctamente y ninguna otra ventana tiene la misma tecla activa.
2
La función se realiza correctamente, pero otra ventana ya tiene la misma tecla activa.

Observaciones

Una tecla activa no se puede asociar a una ventana secundaria.

VK_ESCAPE, VK_SPACE, VK_TAB y VK_PACKET no son claves de acceso rápido no válidas.

Cuando el usuario presiona la tecla activa, el sistema genera un mensaje de WM_SYSCOMMAND con wParam igual a SC_HOTKEY y lParam igual al identificador de la ventana. Si este mensaje se pasa a DefWindowProc, el sistema mostrará el último elemento emergente activo de la ventana (si existe) o la propia ventana (si no hay ninguna ventana emergente) en primer plano.

Una ventana solo puede tener una tecla activa. Si la ventana ya tiene una clave activa asociada, la nueva tecla activa reemplaza a la antigua. Si más de una ventana tiene la misma tecla activa, la ventana que activa la tecla activa es aleatoria.

Estas teclas de acceso rápido no están relacionadas con las teclas de acceso rápido establecidas por RegisterHotKey.

Requisitos

Requisito Importancia
Cliente mínimo compatible
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Cabecera
Winuser.h (incluya Windows.h)

Consulte también

Referencia

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

conceptual de

entrada de teclado