WM_SYSCOMMAND

Una finestra riceve questo messaggio quando l'utente sceglie un comando dal menu della finestra (precedentemente noto come menu di sistema o di controllo) o quando l'utente sceglie il pulsante Ingrandisci, ridurre al minimo il pulsante, pulsante di ripristino o chiudere il pulsante.

WM_SYSCOMMAND uCmdType = wParam;        / / tipo di sistema di comando richiesto da xPos = LOWORD(lParam);    / / posizione orizzontale, nella schermata di coordinate yPos = HIWORD(lParam);    / / coordinate di posizione verticale, nella schermata 
 

Parametri

uCmdType
Specifica il tipo di comando del sistema richiesto. Questo parametro può essere uno dei seguenti valori.
Valore Significato
SC_CLOSE Chiude la finestra.
SC_CONTEXTHELP Cambia il cursore in un punto interrogativo con un puntatore. Se poi l'utente fa clic su un controllo nella finestra di dialogo, il controllo riceve un messaggio WM_HELP.
SC_DEFAULT Seleziona l'elemento predefinito; l'utente fatto doppio clic dal menu finestra.
SC_HOTKEY Attiva la finestra associata al tasto specificato dall'applicazione. La parola di ordine inferiore di lParam identifica la finestra per attivare.
SC_HSCROLL Scorre orizzontalmente.
SC_KEYMENU Recupera dal menu finestra come risultato di una sequenza di tasti.
SC_MAXIMIZE Ingrandisce la finestra.
SC_MINIMIZE Minimizza la finestra.
SC_MONITORPOWERnbsp; & nbsp; Imposta lo stato di visualizzazione. Questo comando supporta i dispositivi che dispongono di funzionalità di risparmio energetico, come ad esempio un personal computer, batteria.

lParam può avere i seguenti valori:

1 indica che la visualizzazione è andare a bassa potenza.

2 indica che il display è essere spento.

SC_MOUSEMENU Recupera dal menu finestra a seguito di un click del mouse.
SC_MOVE Sposta la finestra.
SC_NEXTWINDOW Mosse alla finestra successiva.
SC_PREVWINDOW Mosse alla finestra precedente.
SC_RESTORE Ripristina la finestra alla sua normale posizione e dimensione.
SC_SCREENSAVE Esegue l'applicazione del risparmiatore dello schermo specificato nella sezione [boot] del sistema.File INI.
SC_SIZE Ridimensiona la finestra.
SC_TASKLIST Attiva il menu Start.
SC_VSCROLL Verticale.

xPos
Specifica la posizione orizzontale del cursore, in coordinate dello schermo, se un comando di menu finestra viene selezionato con il mouse. In caso contrario, non viene utilizzato il parametro xPos.
posy
Specifica la posizione verticale del cursore, in coordinate dello schermo, se un comando di menu finestra viene selezionato con il mouse. Questo parametro è – 1 se il comando è stato scelto usando un acceleratore di sistema, o zero se utilizzando un mnenomic.

Valori restituiti

Un'applicazione deve restituire zero se elabora questo messaggio.

Osservazioni

La funzione DefWindowProc effettua la richiesta dal menu finestra per le azioni predefinite specificate nella tabella precedente.

Nei messaggi WM_SYSCOMMAND, i quattro bit meno significativi del parametro uCmdType vengono utilizzati internamente dal sistema. Per ottenere il risultato corretto quando si verifica il valore della uCmdType, un'applicazione deve combinare il valore 0xFFF0 con il valore di uCmdType utilizzando l'operatore AND bit per bit.

Le voci di menu in un menu finestra possono essere modificate utilizzando il GetSystemMenu, AppendMenu, InsertMenu, ModifyMenu, InsertMenuIteme ImpostaVoceMenu funzioni. Le applicazioni che modificare menu finestra devono elaborare i messaggi WM_SYSCOMMAND.

Un'applicazione può eseguire qualsiasi comando di sistema in qualsiasi momento facendo passare un messaggio WM_SYSCOMMAND a DefWindowProc. Eventuali messaggi WM_SYSCOMMAND non gestiti dall'applicazione devono essere passati a DefWindowProc. Qualsiasi comando valori aggiunti da un'applicazione devono essere elaborati dall'applicazione e non possono essere passati a DefWindowProc.

Tasti di scelta rapida che vengono definite per scegliere oggetti dal menu finestra vengono tradotti in messaggi WM_SYSCOMMAND; tutte le altre combinazioni di tasti acceleratore sono tradotti in un messaggio WM_COMMAND.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarata in winuser.

Vedi anche

Panoramica di acceleratori di tastiera, tastiera acceleratore messaggi, Power Management Overview, AppendMenu, DefWindowProc, GetSystemMenu, InsertMenu, ModifyMenu, WM_COMMAND

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index