WM_APPCOMMAND messaggio

Articolo
01/23/2025

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 per la finestra in cui l'utente ha fatto clic sul pulsante o ha premuto il tasto. Può trattarsi di 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 la spinta al basso.
APPCOMMAND_BASS_DOWN 19	Diminuire il basso.
APPCOMMAND_BASS_UP 21	Aumentare il basso.
APPCOMMAND_BROWSER_BACKWARD 1	Spostarsi all'indietro.
APPCOMMAND_BROWSER_FAVORITES 6	Aprire i Preferiti.
APPCOMMAND_BROWSER_FORWARD 2	Spostarsi in avanti.
APPCOMMAND_BROWSER_HOME 7	Spostarsi a casa.
APPCOMMAND_BROWSER_REFRESH 3	Aggiornare la pagina.
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 correzioni quando una parola viene identificata erroneamente durante l'input vocale.
APPCOMMAND_CUT 37	Tagliare la selezione.
APPCOMMAND_DICTATE_OR_COMMAND_CONTROL_TOGGLE 43	Attiva/disattiva tra due modalità di input vocale: dettatura e comando/controllo (dando comandi a un'applicazione o accedendo 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 guida.
APPCOMMAND_LAUNCH_APP1 17	Avviare App1.
APPCOMMAND_LAUNCH_APP2 18	Avviare App2.
APPCOMMAND_LAUNCH_MAIL 15	Aprire posta elettronica.
APPCOMMAND_LAUNCH_MEDIA_SELECT 16	Passare alla modalità Di selezione multimediale.
APPCOMMAND_MEDIA_CHANNEL_DOWN 52	Decrementare il valore del canale, ad esempio, per un televisore o un tuner radio.
APPCOMMAND_MEDIA_CHANNEL_UP 51	Incrementare il valore del canale, ad esempio, per un televisore o un tuner radio.
APPCOMMAND_MEDIA_FAST_FORWARD 49	Aumentare la velocità di riproduzione del flusso. Questo può essere implementato in molti modi, ad esempio, usando una velocità fissa o attivando una serie di velocità crescenti.
APPCOMMAND_MEDIA_NEXTTRACK 11	Vai alla traccia successiva.
APPCOMMAND_MEDIA_PAUSE 47	Pausa. Se è già stata sospesa, non eseguire altre azioni. Si tratta di un comando PAUSE diretto senza stato. Se sono presenti pulsanti Di riproduzione e sospensione discreti, le applicazioni devono intervenire su questo comando e APPCOMMAND_MEDIA_PLAY_PAUSE.
APPCOMMAND_MEDIA_PLAY 46	Inizia a giocare nella posizione corrente. Se è già stata sospesa, verrà ripresa. Si tratta di un comando PLAY diretto senza stato. Se sono presenti discreti Play e pulsanti Sospendi, 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 Play discreti e Sospendi, le applicazioni devono intervenire su questo comando, nonché su APPCOMMAND_MEDIA_PLAY e APPCOMMAND_MEDIA_PAUSE.
APPCOMMAND_MEDIA_PREVIOUSTRACK 12	Andare alla traccia precedente.
APPCOMMAND_MEDIA_RECORD 48	Iniziare a registrare il flusso corrente.
APPCOMMAND_MEDIA_REWIND 50	Andare indietro in un flusso a una velocità più elevata. Questo può essere implementato in molti modi, ad esempio, usando una velocità fissa o attivando una serie di velocità crescenti.
APPCOMMAND_MEDIA_STOP 13	Arresta la riproduzione.
APPCOMMAND_MIC_ON_OFF_TOGGLE 44	Attivare o disattivare 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	Incollare
APPCOMMAND_PRINT 33	Stampare il 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	Diminuire il treble.
APPCOMMAND_TREBLE_UP 23	Aumentare il treble.
APPCOMMAND_UNDO 34	Annulla ultima azione.
APPCOMMAND_VOLUME_DOWN 9	Abbassare il volume.
APPCOMMAND_VOLUME_MUTE 8	Disattivare il volume.
APPCOMMAND_VOLUME_UP 10	Aumentare 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 trattarsi di un mouse o di 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 è in basso.
MK_RBUTTON 0x0002	Il pulsante destro del mouse è in basso.
MK_SHIFT 0x0004	Il tasto MAIUSC è inattivo.
MK_XBUTTON1 0x0020	Il XBUTTON1 è inattivo.
MK_XBUTTON2 0x0040	Il XBUTTON2 è inattivo.

Valore restituito

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

Osservazioni

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 lo elabora. In questo modo il software che simula questo messaggio nei sistemi Windows precedenti a Windows 2000 per determinare se la routine della finestra ha elaborato il messaggio o chiamato DefWindowProc per elaborarlo.

Fabbisogno

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)

Vedere anche

riferimento
DefWindowProc
GET_APPCOMMAND_LPARAM
GET_DEVICE_LPARAM
GET_KEYSTATE_LPARAM
shellProc
WM_XBUTTONUP
WM_NCXBUTTONUP
concettuale
input mouse

Condividi tramite