WM_NCXBUTTONDBLCLK messaggio
Inviato quando l'utente fa doppio clic su XBUTTON1 o XBUTTON2 mentre il cursore si trova nell'area non client di una finestra. Questo messaggio viene inviato alla finestra contenente il cursore. Se una finestra ha acquisito il mouse, questo messaggio non viene pubblicato.
Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.
#define WM_NCXBUTTONDBLCLK 0x00AD
Parametri
-
wParam
-
La parola con ordine basso specifica il valore di hit test restituito dalla funzione defWindowProc
dall'elaborazione del messaggio di WM_NCHITTEST La parola di ordine elevato indica il pulsante su cui è stato fatto doppio clic. Può essere uno dei valori seguenti.
Valore Significato - XBUTTON1
- 0x0001
Il XBUTTON1 è stato fatto doppio clic. - XBUTTON2
- 0x0002
Il secondo XBUTTON2 è stato fatto doppio clic. -
lParam
-
Puntatore a una struttura POINTS che contiene le coordinate x e y del cursore. Le coordinate sono relative all'angolo superiore sinistro dello schermo.
Valore restituito
Se un'applicazione elabora questo messaggio, deve restituire TRUE. Per altre informazioni sull'elaborazione del valore restituito, vedere la sezione Osservazioni.
Osservazioni
Windows supporta i mouse con un massimo di cinque pulsanti: sinistro, centrale e destro, oltre a due pulsanti aggiuntivi denominati XBUTTON1 e XBUTTON2. I pulsanti XBUTTON1 e XBUTTON2 si trovano spesso sui lati del mouse, vicino alla base. Questi pulsanti aggiuntivi non sono presenti su tutti i mouse. Se presente, i pulsanti XBUTTON1 e XBUTTON2 vengono spesso mappati a una funzione dell'applicazione, ad esempio lo spostamento avanti e indietro in un Web browser.
Usare il codice seguente per ottenere le informazioni nel parametro wParam.
nHittest = GET_NCHITTEST_WPARAM(wParam);
fwButton = GET_XBUTTON_WPARAM(wParam);
È anche possibile usare il codice seguente per ottenere le coordinate x e y da lParam:
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Importante
Non utilizzare la LOWORD
Per impostazione predefinita, la funzione DefWindowProc verifica il punto specificato per ottenere la posizione del cursore ed esegue l'azione appropriata. Se appropriato, invia il messaggio di WM_SYSCOMMAND alla finestra.
Per ricevere WM_NCXBUTTONDBLCLK messaggi, una finestra non deve avere lo stile di CS_DBLCLKS. Il sistema genera un messaggio WM_NCXBUTTONDBLCLK quando l'utente preme, rilascia e preme di nuovo un XBUTTON entro il limite di tempo di doppio clic del sistema. Facendo doppio clic su uno di questi pulsanti vengono effettivamente generati quattro messaggi: WM_NCXBUTTONDOWN, WM_NCXBUTTONUP, WM_NCXBUTTONDBLCLKe WM_NCXBUTTONUP di nuovo.
A differenza dei messaggi WM_NCLBUTTONDBLCLK, WM_NCMBUTTONDBLCLKe WM_NCRBUTTONDBLCLK, 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 |
|
Vedere anche
-
riferimento
-
concettuale
-
altre risorse