WM_XBUTTONDBLCLK üzenet

Közzétéve, amikor a felhasználó duplán kattint XBUTTON1 vagy XBUTTON2, miközben a kurzor az ablak ügyfélterületén van. Ha az egér nincs rögzítve, az üzenet a kurzor alatti ablakba kerül. Ellenkező esetben az üzenet arra az ablakra kerül, amely rögzítette az egeret.

Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet.

#define WM_XBUTTONDBLCLK                0x020D

Paraméterek

wParam

Az alacsonyrendű szó azt jelzi, hogy a különböző virtuális kulcsok le vannak-e omlva. Az alábbi értékek közül egy vagy több is lehet.

Érték	Jelentés
MK_CONTROL 0x0008	A CTRL billentyű le van omlva.
MK_LBUTTON 0x0001	A bal egérgomb le van gombra kattintva.
MK_MBUTTON 0x0010	A középső egérgomb le van va.
MK_RBUTTON 0x0002	A jobb egérgomb le van omlva.
MK_SHIFT 0x0004	A SHIFT billentyű le van omlva.
MK_XBUTTON1 0x0020	A XBUTTON1 leállt.
MK_XBUTTON2 0x0040	A XBUTTON2 leállt.

A magasrendű szó azt jelzi, hogy melyik gombra kattintott duplán. Az alábbi értékek egyike lehet.

Érték	Jelentés
XBUTTON1 0x0001	A XBUTTON1 duplán kattintott.
XBUTTON2 0x0002	A XBUTTON2 duplán kattintott.

lParam

Az alacsonyrendű szó a kurzor x koordinátáját adja meg. A koordináta az ügyfélterület bal felső sarkához viszonyítva van.

A magasrendű szó a kurzor y koordinátáját adja meg. A koordináta az ügyfélterület bal felső sarkához viszonyítva van.

Visszaadott érték

Ha egy alkalmazás feldolgozza ezt az üzenetet, TRUEértéket kell visszaadnia. A visszatérési érték feldolgozásával kapcsolatos további információkért lásd a Megjegyzések szakaszt.

Megjegyzések

A Windows legfeljebb öt gombbal támogatja az egereket: balra, középen és jobbra, valamint két további gombot XBUTTON1 és XBUTTON2. A XBUTTON1 és XBUTTON2 gombok gyakran az egér oldalán, az alap közelében találhatók. Ezek az extra gombok nem minden egéren vannak jelen. Ha van ilyen, a XBUTTON1 és a XBUTTON2 gombok gyakran egy alkalmazásfüggvényhez vannak leképezve, például a webböngésző előre- és hátrafelé történő navigációjához.

Az alábbi kóddal lekérheti a wParam paraméter adatait:

fwKeys = GET_KEYSTATE_WPARAM (wParam); 
fwButton = GET_XBUTTON_WPARAM (wParam); 

A vízszintes és a függőleges pozíció beolvasásához használja a következő kódot:

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

Amint fentebb említettük, az x koordináták a visszatérési érték alacsony rövid; az y koordináta nagy sorrendben rövid (mindkettő aláírt értékeket jelöl, mert több monitorral rendelkező rendszereken negatív értékeket vehet fel). Ha a visszatérési érték egy változóhoz van rendelve, a MAKEPOINTS makróval lekérhet egy PONT struktúrát a visszatérési értékből. A GET_X_LPARAM vagy GET_Y_LPARAM makróval is kinyerheti az x vagy az y koordinátát.

Csak a CS_DBLCLKS stílussal rendelkező ablakok fogadhatnak WM_XBUTTONDBLCLK üzeneteket, amelyeket a rendszer akkor hoz létre, amikor a felhasználó megnyomja, kiadja, majd ismét lenyomja XBUTTON1 vagy XBUTTON2 a rendszer dupla kattintásos időkorlátján belül. A gombok egyikére duplán kattintva valójában négy üzenet jelenik meg: WM_XBUTTONDOWN, WM_XBUTTONUP, WM_XBUTTONDBLCLKés újra WM_XBUTTONUP.

A WM_LBUTTONDBLCLK, WM_MBUTTONDBLCLKés WM_RBUTTONDBLCLK üzenetekkel ellentétben az alkalmazásnak IGAZ kell visszaadnia, ha feldolgozza. Ezzel lehetővé teszi, hogy a Windows 2000-nél korábbi Windows rendszereken az üzenetet szimuláló szoftverek megállapíthassák, hogy az ablak eljárás feldolgozta-e az üzenetet, vagy DefWindowProc meghívta a feldolgozásra.

Követelmények

Lásd még:

referencia

DefWindowProc

GET_KEYSTATE_WPARAM

GET_X_LPARAM

GET_XBUTTON_WPARAM

GET_Y_LPARAM

GetCapture

GetDoubleClickTime

SetDoubleClickTime

WM_XBUTTONDOWN

WM_XBUTTONUP

fogalmi

egérbemeneti

Egyéb erőforrások

MAKEPOINTS

POINTS