Compartir a través de

mensaje de WM_APPCOMMAND

  • Artículo

Notifica a una ventana que el usuario generó un evento de comando de aplicación, por ejemplo, haciendo clic en un botón de comando de aplicación mediante el mouse o escribiendo una tecla de comando de aplicación en el teclado.

#define WM_APPCOMMAND                   0x0319

Parámetros

wParam

Identificador de la ventana donde el usuario hace clic en el botón o presiona la tecla. Puede ser una ventana secundaria de la ventana que recibe el mensaje. Para obtener más información sobre cómo procesar este mensaje, vea la sección Comentarios.

lParam

Use el código siguiente para obtener la información contenida en el parámetro lParam.

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

El comando de aplicación es cmd, que puede ser uno de los siguientes valores.

Valor Significado
APPCOMMAND_BASS_BOOST
20
 Activa y desactiva la potencia del bajo.
APPCOMMAND_BASS_DOWN
19
 Disminuya el bajo.
APPCOMMAND_BASS_UP
21
 Aumente el bajo.
APPCOMMAND_BROWSER_BACKWARD
1
 Navegue hacia atrás.
APPCOMMAND_BROWSER_FAVORITES
6
 Abra favoritos.
APPCOMMAND_BROWSER_FORWARD
2
 Vaya hacia adelante.
APPCOMMAND_BROWSER_HOME
7
 Vaya a casa.
APPCOMMAND_BROWSER_REFRESH
3
 Página Actualizar.
APPCOMMAND_BROWSER_SEARCH
5
 Abra la búsqueda.
APPCOMMAND_BROWSER_STOP
4
 Detenga la descarga.
APPCOMMAND_CLOSE
31
 Cierre la ventana (no la aplicación).
APPCOMMAND_COPY
36
 Copie la selección.
APPCOMMAND_CORRECTION_LIST
45
 Muestra la lista de corrección cuando una palabra se identifica incorrectamente durante la entrada de voz.
APPCOMMAND_CUT
37
 Corte la selección.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
43
 Alterna entre dos modos de entrada de voz: dictado y comando/control (dando comandos a una aplicación o acceso a menús).
APPCOMMAND_FIND
28
 Abra el cuadro de diálogo Buscar .
APPCOMMAND_FORWARD_MAIL
40
 Reenvíe un mensaje de correo.
APPCOMMAND_HELP
27
 Abra el cuadro de diálogo Ayuda.
APPCOMMAND_LAUNCH_APP1
17
 Inicie App1.
APPCOMMAND_LAUNCH_APP2
18
 Inicie App2.
APPCOMMAND_LAUNCH_MAIL
15
 Abra el correo.
APPCOMMAND_LAUNCH_MEDIA_SELECT
16
 Vaya al modo Seleccionar multimedia.
APPCOMMAND_MEDIA_CHANNEL_DOWN
52
 Decremento el valor del canal, por ejemplo, para un sintonizador de tv o radio.
APPCOMMAND_MEDIA_CHANNEL_UP
51
 Incremente el valor del canal, por ejemplo, para un televisor o un sintonizador de radio.
APPCOMMAND_MEDIA_FAST_FORWARD
49
 Aumente la velocidad de reproducción de secuencias. Esto se puede implementar de muchas maneras, por ejemplo, usando una velocidad fija o alternando a través de una serie de velocidades crecientes.
APPCOMMAND_MEDIA_NEXTTRACK
11
 Vaya a la siguiente pista.
APPCOMMAND_MEDIA_PAUSE
47
 Pausa. Si ya está en pausa, no realice ninguna otra acción. Se trata de un comando PAUSE directo que no tiene ningún estado. Si hay botones discretos reproducir y pausar, las aplicaciones deben tomar medidas en este comando, así como APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY
46
 Comience a jugar en la posición actual. Si ya está en pausa, se reanudará. Se trata de un comando direct PLAY que no tiene ningún estado. Si hay botones discretos Play y Pausar, las aplicaciones deben tomar medidas en este comando, así como APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY_PAUSE
14
 Reproducir o pausar la reproducción. Si hay botones discretos Reproducir y Pausar, las aplicaciones deben tomar medidas en este comando, así como APPCOMMAND_MEDIA_PLAY y APPCOMMAND_MEDIA_PAUSE.
APPCOMMAND_MEDIA_PREVIOUSTRACK
12
 Vaya a la pista anterior.
APPCOMMAND_MEDIA_RECORD
48
 Comience a grabar la secuencia actual.
APPCOMMAND_MEDIA_REWIND
50
 Retroceda en una secuencia a una velocidad más alta. Esto se puede implementar de muchas maneras, por ejemplo, usando una velocidad fija o alternando a través de una serie de velocidades crecientes.
APPCOMMAND_MEDIA_STOP
13
 Detenga la reproducción.
APPCOMMAND_MIC_ON_OFF_TOGGLE
44
 Alternar el micrófono.
APPCOMMAND_MICROPHONE_VOLUME_DOWN
25
 Reduzca el volumen del micrófono.
APPCOMMAND_MICROPHONE_VOLUME_MUTE
24
 Silenciar el micrófono.
APPCOMMAND_MICROPHONE_VOLUME_UP
26
 Aumente el volumen del micrófono.
APPCOMMAND_NEW
29
 Cree una nueva ventana.
APPCOMMAND_OPEN
30
 Abra una ventana.
APPCOMMAND_PASTE
38
 Pegar
APPCOMMAND_PRINT
33
 Imprimir documento actual.
APPCOMMAND_REDO
35
 Rehacer la última acción.
APPCOMMAND_REPLY_TO_MAIL
39
 Responder a un mensaje de correo.
APPCOMMAND_SAVE
32
 Guarde el documento actual.
APPCOMMAND_SEND_MAIL
41
 Enviar un mensaje de correo.
APPCOMMAND_SPELL_CHECK
42
 Inicie una revisión ortográfica.
APPCOMMAND_TREBLE_DOWN
22
 Disminuya el triple.
APPCOMMAND_TREBLE_UP
23
 Aumente el triple.
APPCOMMAND_UNDO
34
 Deshacer la última acción.
APPCOMMAND_VOLUME_DOWN
9
 Reduzca el volumen.
APPCOMMAND_VOLUME_MUTE
8
 Silenciar el volumen.
APPCOMMAND_VOLUME_UP
10
 Aumente el volumen.

El componente uDevice indica el dispositivo de entrada que generó el evento de entrada y puede ser uno de los siguientes valores.

Valor Significado
FAPPCOMMAND_KEY
0
 El usuario ha presionado una tecla.
FAPPCOMMAND_MOUSE
0x8000
 El usuario ha clic en un botón del mouse.
FAPPCOMMAND_OEM
0x1000
 Un origen de hardware no identificado generó el evento. Podría ser un ratón o un evento de teclado.

El componente dwKeys indica si hay varias claves virtuales inactivas y puede ser uno o varios de los valores siguientes.

Valor Significado
MK_CONTROL
0x0008
 La tecla CTRL está presionada.
MK_LBUTTON
0x0001
 El botón izquierdo del mouse está inactivo.
MK_MBUTTON
0x0010
 El botón central del mouse está inactivo.
MK_RBUTTON
0x0002
 El botón derecho del mouse está inactivo.
MK_SHIFT
0x0004
 La tecla MAYÚS está inactiva.
MK_XBUTTON1
0x0020
 El XBUTTON1 está inactivo.
MK_XBUTTON2
0x0040
 El XBUTTON2 está inactivo.

Valor devuelto

Si una aplicación procesa este mensaje, debe devolver TRUE. Para obtener más información sobre cómo procesar el valor devuelto, vea la sección Comentarios.

Observaciones

DefWindowProc genera el mensaje de WM_APPCOMMAND cuando procesa el mensaje de WM_XBUTTONUP o WM_NCXBUTTONUP, o cuando el usuario escribe una clave de comando de aplicación.

Si una ventana secundaria no procesa este mensaje y, en su lugar, llama a DefWindowProc, DefWindowProc enviará el mensaje a su ventana primaria. Si una ventana de nivel superior no procesa este mensaje y, en su lugar, llama a DefWindowProc, DefWindowProc llamará a un enlace de shell con el código de enlace igual a HSHELL_APPCOMMAND.

Para obtener las coordenadas del cursor si un clic del mouse generó el mensaje, la aplicación puede llamar a GetMessagePos. Una aplicación puede probar si el mouse generó el mensaje comprobando si lParam contiene FAPPCOMMAND_MOUSE.

A diferencia de otros mensajes de Windows, una aplicación debe devolver TRUE de este mensaje si la procesa. Si lo hace, permitirá que el software que simula este mensaje en sistemas Windows anteriores a Windows 2000 determine si el procedimiento de ventana procesó el mensaje o se llamó a DefWindowProc procesarlo.

Requisitos

Requisito Valor
Cliente mínimo admitido
 Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo admitido
 Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluya Windows.h)

Consulte también

de referencia de

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

conceptual de

de entrada del mouse