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 |
|
Consulte también
-
de referencia de
-
conceptual de