windows_programming_notes.nbk: Home | Index | Next Page: WM_NCMOUSELEAVE | Previous Page: WM_NCMBUTTONUP

 WM_NCMOUSEHOVER

The WM_NCMOUSEHOVER message is posted to a window when the cursor hovers over the nonclient area of the window for the period of time specified in a prior call to TrackMouseEvent.

A window receives this message through its WindowProc function.

Syntax

    WM_NCMOUSEHOVER
        WPARAM wParam
        LPARAM lParam;

Parameters

• wParam
  Specifies the hit-test value returned by the DefWindowProc function as a result of processing the WM_NCHITTEST message. For a list of hit-test values, see WM_NCHITTEST.
• lParam
  Specifies a POINTS structure that contains the x- and y-coordinates of the cursor. The coordinates are relative to the upper-left corner of the screen.

Return Value

If an application processes this message, it should return zero.

Remarks

Hover tracking stops when this message is generated. The application must call TrackMouseEvent again if it requires further tracking of mouse hover behavior.

You can also use the GET_X_LPARAM and GET_Y_LPARAM macros to extract the values of the x- and y- coordinates from lParam.

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

Notification Requirements

• Minimum DLL Version None
• Header Declared in Winuser.h, include Windows.h
• Minimum operating systems Windows 98, Windows 2000

windows_programming_notes.nbk: Home | Index | Next Page: WM_NCMOUSELEAVE | Previous Page: WM_NCMBUTTONUP

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time