Condividi tramite


WM_APPCOMMAND messaggio

Notifica a una finestra che l'utente ha generato un evento di comando dell'applicazione, ad esempio facendo clic su un pulsante di comando dell'applicazione usando il mouse o digitando un tasto di comando dell'applicazione sulla tastiera.

#define WM_APPCOMMAND                   0x0319

Parametri

wParam

Handle nella finestra in cui l'utente ha fatto clic sul pulsante o premuto il tasto. Questa può essere una finestra figlio della finestra che riceve il messaggio. Per altre informazioni sull'elaborazione di questo messaggio, vedere la sezione Osservazioni.

lParam

Usare il codice seguente per ottenere le informazioni contenute nel parametro lParam .

cmd  = GET_APPCOMMAND_LPARAM(lParam);

uDevice = GET_DEVICE_LPARAM(lParam);

dwKeys = GET_KEYSTATE_LPARAM(lParam);

Il comando dell'applicazione è cmd, che può essere uno dei valori seguenti.

Valore Significato
APPCOMMAND_BASS_BOOST
20
Attivare e disattivare l'attivazione del basso.
APPCOMMAND_BASS_DOWN
19
Ridurre i bassi.
APPCOMMAND_BASS_UP
21
Aumentare il basso.
APPCOMMAND_BROWSER_BACKWARD
1
Spostarsi indietro.
APPCOMMAND_BROWSER_FAVORITES
6
Aprire preferiti.
APPCOMMAND_BROWSER_FORWARD
2
Passare avanti.
APPCOMMAND_BROWSER_HOME
7
Spostarsi a casa.
APPCOMMAND_BROWSER_REFRESH
3
Pagina Aggiorna.
APPCOMMAND_BROWSER_SEARCH
5
Aprire la ricerca.
APPCOMMAND_BROWSER_STOP
4
Arrestare il download.
APPCOMMAND_CLOSE
31
Chiudere la finestra (non l'applicazione).
APPCOMMAND_COPY
36
Copiare la selezione.
APPCOMMAND_CORRECTION_LIST
45
Visualizza l'elenco di correzione quando una parola viene identificata in modo errato durante l'input vocale.
APPCOMMAND_CUT
37
Tagliare la selezione.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE
43
Disattiva tra due modalità di input vocale: dettatura e comando/controllo (dando comandi a un'applicazione o a un'accesso ai menu).
APPCOMMAND_FIND
28
Aprire la finestra di dialogo Trova .
APPCOMMAND_FORWARD_MAIL
40
Inoltrare un messaggio di posta elettronica.
APPCOMMAND_HELP
27
Aprire la finestra di dialogo Della Guida .
APPCOMMAND_LAUNCH_APP1
17
Avviare App1.
APPCOMMAND_LAUNCH_APP2
18
Avviare App2.
APPCOMMAND_LAUNCH_MAIL
15
Aprire la posta elettronica.
APPCOMMAND_LAUNCH_MEDIA_SELECT
16
Passare alla modalità Selezione multimediale.
APPCOMMAND_MEDIA_CHANNEL_DOWN
52
Decrementare il valore del canale, ad esempio per una TV o un tuner radio.
APPCOMMAND_MEDIA_CHANNEL_UP
51
Aumentare il valore del canale, ad esempio per una tv o un tuner radio.
APPCOMMAND_MEDIA_FAST_FORWARD
49
Aumentare la velocità di riproduzione del flusso. Ciò può essere implementato in molti modi, ad esempio usando una velocità fissa o attivando una serie di velocità crescenti.
APPCOMMAND_MEDIA_NEXTTRACK
11
Passare alla traccia successiva.
APPCOMMAND_MEDIA_PAUSE
47
Sospendi. Se già sospeso, non eseguire ulteriori azioni. Si tratta di un comando PAUSE diretto che non ha stato. Se sono presenti pulsanti Play e Pause discreti, le applicazioni devono eseguire azioni su questo comando e APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY
46
Iniziare a giocare nella posizione corrente. Se già sospeso, riprenderà. Si tratta di un comando PLAY diretto che non ha stato. Se sono presenti pulsanti Play e Pause discreti, le applicazioni devono intervenire su questo comando e su APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY_PAUSE
14
Riprodurre o sospendere la riproduzione. Se sono presenti pulsanti Di riproduzione e sospensione discreti, le applicazioni devono eseguire azioni su questo comando, nonché APPCOMMAND_MEDIA_PLAY e APPCOMMAND_MEDIA_PAUSE.
APPCOMMAND_MEDIA_PREVIOUSTRACK
12
Passare alla traccia precedente.
APPCOMMAND_MEDIA_RECORD
48
Iniziare a registrare il flusso corrente.
APPCOMMAND_MEDIA_REWIND
50
Tornare indietro in un flusso a una velocità superiore. Ciò può essere implementato in molti modi, ad esempio usando una velocità fissa o attivando una serie di velocità crescenti.
APPCOMMAND_MEDIA_STOP
13
Arrestare la riproduzione.
APPCOMMAND_MIC_ON_OFF_TOGGLE
44
Disattiva il microfono.
APPCOMMAND_MICROPHONE_VOLUME_DOWN
25
Ridurre il volume del microfono.
APPCOMMAND_MICROPHONE_VOLUME_MUTE
24
Disattivare il microfono.
APPCOMMAND_MICROPHONE_VOLUME_UP
26
Aumentare il volume del microfono.
APPCOMMAND_NEW
29
Creare una nuova finestra.
APPCOMMAND_OPEN
30
Aprire una finestra.
APPCOMMAND_PASTE
38
Incolla
APPCOMMAND_PRINT
33
Stampa documento corrente.
APPCOMMAND_REDO
35
Ripetere l'ultima azione.
APPCOMMAND_REPLY_TO_MAIL
39
Rispondere a un messaggio di posta elettronica.
APPCOMMAND_SAVE
32
Salvare il documento corrente.
APPCOMMAND_SEND_MAIL
41
Inviare un messaggio di posta elettronica.
APPCOMMAND_SPELL_CHECK
42
Avviare un controllo ortografico.
APPCOMMAND_TREBLE_DOWN
22
Ridurre l'abilità.
APPCOMMAND_TREBLE_UP
23
Aumentare il treble.
APPCOMMAND_UNDO
34
Annullare l'ultima azione.
APPCOMMAND_VOLUME_DOWN
9
Ridurre il volume.
APPCOMMAND_VOLUME_MUTE
8
Disattivare il volume.
APPCOMMAND_VOLUME_UP
10
Generare il volume.

Il componente uDevice indica il dispositivo di input che ha generato l'evento di input e può essere uno dei valori seguenti.

Valore Significato
FAPPCOMMAND_KEY
0
L'utente ha premuto un tasto.
FAPPCOMMAND_MOUSE
0x8000
L'utente ha fatto clic su un pulsante del mouse.
FAPPCOMMAND_OEM
0x1000
Un'origine hardware non identificata ha generato l'evento. Potrebbe essere un mouse o un evento della tastiera.

Il componente dwKeys indica se varie chiavi virtuali sono inattive e possono essere uno o più dei valori seguenti.

Valore Significato
MK_CONTROL
0x0008
Il tasto CTRL è inattivo.
MK_LBUTTON
0x0001
Il pulsante sinistro del mouse è in basso.
MK_MBUTTON
0x0010
Il pulsante centrale del mouse è inattivo.
MK_RBUTTON
0x0002
Il pulsante destro del mouse è inattivo.
MK_SHIFT
0x0004
Il tasto MAIUSC è inattivo.
MK_XBUTTON1
0x0020
Il primo pulsante X è inattivo.
MK_XBUTTON2
0x0040
Il secondo pulsante X è inattivo.

Valore restituito

Se un'applicazione elabora questo messaggio, deve restituire TRUE. Per altre informazioni sull'elaborazione del valore restituito, vedere la sezione Osservazioni.

Commenti

DefWindowProc genera il messaggio di WM_APPCOMMAND quando elabora il messaggio WM_XBUTTONUP o WM_NCXBUTTONUP oppure quando l'utente digita una chiave di comando dell'applicazione.

Se una finestra figlio non elabora questo messaggio e chiama invece DefWindowProc, DefWindowProc invierà il messaggio alla finestra padre. Se una finestra di primo livello non elabora questo messaggio e chiama invece DefWindowProc, DefWindowProc chiamerà un hook della shell con il codice hook uguale a HSHELL_APPCOMMAND.

Per ottenere le coordinate del cursore se il messaggio è stato generato da un clic del mouse, l'applicazione può chiamare GetMessagePos. Un'applicazione può verificare se il messaggio è stato generato dal mouse controllando se lParam contiene FAPPCOMMAND_MOUSE.

A differenza di altri messaggi di Windows, un'applicazione deve restituire TRUE da questo messaggio se la elabora. In questo modo, il software che simula questo messaggio nei sistemi Windows precedenti a Windows 2000 consente di determinare se la routine della finestra ha elaborato il messaggio o chiamato DefWindowProc per elaborarlo.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Winuser.h (include Windows.h)

Vedi anche

Riferimento

DefWindowProc

GET_APPCOMMAND_LPARAM

GET_DEVICE_LPARAM

GET_KEYSTATE_LPARAM

ShellProc

WM_XBUTTONUP

WM_NCXBUTTONUP

Informazioni concettuali

Mouse Input