WM_SETHOTKEY mensaje

  • Artículo

Se envía a una ventana para asociar una tecla activa a la ventana. Cuando el usuario presiona la tecla de acceso rápido, el sistema activa la ventana.

#define WM_SETHOTKEY                    0x0032

Parámetros

wParam

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

La palabra de orden superior puede ser uno o varios de los valores siguientes de CommCtrl.h.

Si se establece wParam en NULL , se quita la clave activa asociada a una ventana.

Valor Significado
HOTKEYF_ALT
0x04
 tecla ALT
HOTKEYF_CONTROL
0x02
 Tecla CTRL
HOTKEYF_EXT
0x08
 Tecla extendida
HOTKEYF_SHIFT
0x01
 Tecla Mayús

lParam

Este parámetro no se utiliza.

Valor devuelto

El valor devuelto es uno de los siguientes.

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

Comentarios

Una tecla de acceso rápido no se puede asociar a una ventana secundaria.

VK_ESCAPE, VK_SPACE y VK_TAB 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 ventana en sí (si no hay ninguna ventana emergente) en primer plano.

Una ventana solo puede tener una tecla activa. Si la ventana ya tiene una tecla 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 Value
Cliente mínimo compatible
 Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluye Windows.h)

Consulte también

Referencia

RegisterHotKey

WM_GETHOTKEY

WM_SYSCOMMAND

Conceptual

Entrada de teclado