WM_LBUTTONDOWN messaggio

Articolo
01/23/2025

Inviato quando l'utente preme il pulsante sinistro del mouse mentre il cursore si trova nell'area client di una finestra. Se il mouse non viene acquisito, il messaggio viene inserito nella finestra sotto il cursore. In caso contrario, il messaggio viene inviato alla finestra che ha acquisito il mouse.

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc.

#define WM_LBUTTONDOWN                  0x0201

Parametri

wParam

Indica se diverse chiavi virtuali sono inattivi. Questo parametro può 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.

lParam

La parola con ordine basso specifica la coordinata x del cursore. La coordinata è relativa all'angolo superiore sinistro dell'area client.

La parola di ordine elevato specifica la coordinata y del cursore. La coordinata è relativa all'angolo superiore sinistro dell'area client.

Valore restituito

Se un'applicazione elabora questo messaggio, deve restituire zero.

Esempio

LRESULT CALLBACK WndProc(_In_ HWND hWnd, _In_ UINT msg, _In_ WPARAM wParam, _In_ LPARAM lParam)
{
    POINT pt;

    switch (msg)
    {

    case WM_LBUTTONDOWN:
            {
                pt.x = GET_X_LPARAM(lParam);
                pt.y = GET_Y_LPARAM(lParam);
            }
        break;

    default:
        return DefWindowProc(hWnd, msg, wParam, lParam);
    }
    return 0;
}

Per altri esempi, vedere esempi classici di Windows su GitHub.

Osservazioni

Come indicato in precedenza, la coordinata x è nell'ordine basso breve del valore restituito; la coordinata y si trova nell' breve di ordine elevato (entrambi rappresentano valori firmati perché possono accettare valori negativi nei sistemi con più monitor). Se il valore restituito viene assegnato a una variabile, è possibile utilizzare la macro MAKEPOINTS per ottenere una struttura POINTS dal valore restituito. È anche possibile utilizzare la macro GET_X_LPARAM o GET_Y_LPARAM per estrarre la coordinata x o y.

Importante

Non utilizzare la LOWORD o macro HIWORD per estrarre le coordinate x e y della posizione del cursore perché queste macro restituiscono risultati non corretti nei sistemi con più monitor. I sistemi con più monitor possono avere coordinate x e y negative e LOWORD e HIWORD considerano le coordinate come quantità non firmate.

Per rilevare che il tasto ALT è stato premuto, controllare se GetKeyState con VK_MENU< 0. Si noti che non deve essere GetAsyncKeyState.

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 Windowsx.h)

Vedere anche

riferimento
GET_X_LPARAM
GET_Y_LPARAM
GetCapture
GetKeyState
SetCapture
WM_LBUTTONDBLCLK
WM_LBUTTONUP
concettuale
input mouse
altre risorse
MAKEPOINTS
POINTS

Condividi tramite