Partilhar via

WM_APPCOMMAND mensagem

  • Artigo

Notifica uma janela de que o usuário gerou um evento de comando do aplicativo, por exemplo, clicando em um botão de comando do aplicativo usando o mouse ou digitando uma tecla de comando do aplicativo no teclado.

#define WM_APPCOMMAND                   0x0319

Parâmetros

wParam

Uma alça para a janela onde o usuário clicou no botão ou pressionou a tecla. Esta pode ser uma janela filho da janela que recebe a mensagem. Para obter mais informações sobre como processar essa mensagem, consulte a seção Comentários.

lParam

Use o código a seguir para obter as informações contidas no parâmetro lParam.

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

O comando application é cmd, que pode ser um dos seguintes valores.

Valor Significado
APPCOMMAND_BASS_BOOST
20
 Ative e desative o aumento de graves.
APPCOMMAND_BASS_DOWN
19
 Diminua os graves.
APPCOMMAND_BASS_UP
21
 Aumente os graves.
APPCOMMAND_BROWSER_BACKWARD
1
 Navegue para trás.
APPCOMMAND_BROWSER_FAVORITES
6
 Abra os favoritos.
APPCOMMAND_BROWSER_FORWARD
2
 Navegue para a frente.
APPCOMMAND_BROWSER_HOME
7
 Navegue para casa.
APPCOMMAND_BROWSER_REFRESH
3
 Atualizar página.
APPCOMMAND_BROWSER_SEARCH
5
 Abra a pesquisa.
APPCOMMAND_BROWSER_STOP
4
 Pare o download.
APPCOMMAND_CLOSE
31
 Feche a janela (não o aplicativo).
APPCOMMAND_COPY
36
 Copie a seleção.
APPCOMMAND_CORRECTION_LIST
45
 Exibe a lista de correção quando uma palavra é identificada incorretamente durante a entrada de fala.
APPCOMMAND_CUT
37
 Corte a seleção.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
43
 Alterna entre dois modos de entrada de voz: ditado e comando/controlo (dar comandos a uma aplicação ou aceder a menus).
APPCOMMAND_FIND
28
 Abra a caixa de diálogo Localizar.
APPCOMMAND_FORWARD_MAIL
40
 Encaminhar uma mensagem de email.
APPCOMMAND_HELP
27
 Abra a caixa de diálogo Ajuda do .
APPCOMMAND_LAUNCH_APP1
17
 Inicie o App1.
APPCOMMAND_LAUNCH_APP2
18
 Inicie o App2.
APPCOMMAND_LAUNCH_MAIL
15
 Abra o e-mail.
APPCOMMAND_LAUNCH_MEDIA_SELECT
16
 Vá para o modo de seleção de mídia.
APPCOMMAND_MEDIA_CHANNEL_DOWN
52
 Diminuir o valor do canal, por exemplo, para um sintonizador de TV ou rádio.
APPCOMMAND_MEDIA_CHANNEL_UP
51
 Aumente o valor do canal, por exemplo, para um sintonizador de TV ou rádio.
APPCOMMAND_MEDIA_FAST_FORWARD
49
 Aumente a velocidade de reprodução do streaming. Isso pode ser implementado de muitas maneiras, por exemplo, usando uma velocidade fixa ou alternando através de uma série de velocidades crescentes.
APPCOMMAND_MEDIA_NEXTTRACK
11
 Vá para a próxima faixa.
APPCOMMAND_MEDIA_PAUSE
47
 Pausa. Se já estiver pausado, não tome mais nenhuma medida. Este é um comando PAUSE direto que não tem estado. Se houver botões Reproduzir e Pausar discretos, os aplicativos devem agir nesse comando, bem como APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY
46
 Comece a jogar na posição atual. Se já estiver pausado, será retomado. Este é um comando PLAY direto que não tem estado. Se existirem botões discretos Play e Pausar, as aplicações devem tomar medidas sobre este comando, bem como APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY_PAUSE
14
 Reproduzir ou pausar a reprodução. Se houver discretos Reproduzir e botões Pausar, os aplicativos devem agir nesse comando, bem como APPCOMMAND_MEDIA_PLAY e APPCOMMAND_MEDIA_PAUSE.
APPCOMMAND_MEDIA_PREVIOUSTRACK
12
 Ir para a faixa anterior.
APPCOMMAND_MEDIA_RECORD
48
 Comece a gravar o fluxo atual.
APPCOMMAND_MEDIA_REWIND
50
 Volte para trás em um fluxo a uma taxa mais alta de velocidade. Isso pode ser implementado de muitas maneiras, por exemplo, usando uma velocidade fixa ou alternando através de uma série de velocidades crescentes.
APPCOMMAND_MEDIA_STOP
13
 Pare a reprodução.
APPCOMMAND_MIC_ON_OFF_TOGGLE
44
 Alterne o microfone.
APPCOMMAND_MICROPHONE_VOLUME_DOWN
25
 Diminua o volume do microfone.
APPCOMMAND_MICROPHONE_VOLUME_MUTE
24
 Silencie o microfone.
APPCOMMAND_MICROPHONE_VOLUME_UP
26
 Aumente o volume do microfone.
APPCOMMAND_NEW
29
 Crie uma nova janela.
APPCOMMAND_OPEN
30
 Abra uma janela.
APPCOMMAND_PASTE
38
 Colar
APPCOMMAND_PRINT
33
 Imprima o documento atual.
APPCOMMAND_REDO
35
 Refazer a última ação.
APPCOMMAND_REPLY_TO_MAIL
39
 Responder a uma mensagem de email.
APPCOMMAND_SAVE
32
 Salve o documento atual.
APPCOMMAND_SEND_MAIL
41
 Envie uma mensagem de email.
APPCOMMAND_SPELL_CHECK
42
 Inicie uma verificação ortográfica.
APPCOMMAND_TREBLE_DOWN
22
 Diminua os agudos.
APPCOMMAND_TREBLE_UP
23
 Aumente os agudos.
APPCOMMAND_UNDO
34
 Desfazer a última ação.
APPCOMMAND_VOLUME_DOWN
9
 Diminua o volume.
APPCOMMAND_VOLUME_MUTE
8
 Silencie o volume.
APPCOMMAND_VOLUME_UP
10
 Aumente o volume.

O componente uDevice indica o dispositivo de entrada que gerou o evento de entrada e pode ser um dos seguintes valores.

Valor Significado
FAPPCOMMAND_KEY
0
 O usuário pressionou uma tecla.
FAPPCOMMAND_MOUSE
0x8000
 O usuário clicou em um botão do mouse.
FAPPCOMMAND_OEM
0x1000
 Uma fonte de hardware não identificada gerou o evento. Pode ser um evento de mouse ou teclado.

O componente dwKeys indica se várias chaves virtuais estão inativas e podem ser um ou mais dos seguintes valores.

Valor Significado
MK_CONTROL
0x0008
 A tecla CTRL está inativa.
MK_LBUTTON
0x0001
 O botão esquerdo do rato está inativo.
MK_MBUTTON
0x0010
 O botão do meio do mouse está para baixo.
MK_RBUTTON
0x0002
 O botão direito do rato está inativo.
MK_SHIFT
0x0004
 A tecla SHIFT está inativa.
MK_XBUTTON1
0x0020
 O XBUTTON1 está em baixa.
MK_XBUTTON2
0x0040
 A XBUTTON2 está em baixa.

Valor de retorno

Se um aplicativo processar essa mensagem, ele deverá retornar TRUE. Para obter mais informações sobre como processar o valor de retorno, consulte a seção Comentários.

Comentários

DefWindowProc gera a mensagem WM_APPCOMMAND quando processa a mensagem WM_XBUTTONUP ou WM_NCXBUTTONUP ou quando o usuário digita uma chave de comando do aplicativo.

Se uma janela filho não processar essa mensagem e, em vez disso, chamar DefWindowProc , DefWindowProc enviará a mensagem para sua janela pai. Se uma janela de nível superior não processar essa mensagem e, em vez disso, chamar DefWindowProc , DefWindowProc chamará um gancho de shell com o código de gancho igual a HSHELL_APPCOMMAND.

Para obter as coordenadas do cursor se a mensagem foi gerada por um clique do mouse, o aplicativo pode chamar GetMessagePos. Um aplicativo pode testar se a mensagem foi gerada pelo mouse, verificando se lParam contém FAPPCOMMAND_MOUSE.

Ao contrário de outras mensagens do Windows, um aplicativo deve retornar TRUE dessa mensagem se processá-la. Isso permitirá que o software que simula essa mensagem em sistemas Windows anteriores ao Windows 2000 determine se o procedimento de janela processou a mensagem ou chamou DefWindowProc para processá-la.

Requerimentos

Exigência Valor
Cliente mínimo suportado
 Windows 2000 Professional [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado
 Windows 2000 Server [apenas aplicações de ambiente de trabalho]
Cabeçalho
Winuser.h (inclui Windows.h)

Ver também

de referência

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

Conceptual

de entrada do mouse