Compartir a través de


mensaje de WM_APPCOMMAND

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