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 |
|
Vedi anche
-
Riferimento
-
Informazioni concettuali
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per