WM_APPCOMMAND messaggio

Articolo
06/13/2023

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

Condividi tramite