ClientToScreen

Article
06/30/2006

This function converts the client coordinates of a specified point to screen coordinates.

BOOL ClientToScreen( 
  HWND hWnd, 
  LPPOINT lpPoint
);

Parameters

hWnd
Handle to the window whose client area is used for the conversion.
lpPoint
Long pointer to a POINT structure that contains the client coordinates to be converted. The new screen coordinates are copied into this structure if the function succeeds.

Return Values

Nonzero indicates success. Zero indicates failure.

To get extended error information, call GetLastError.

Code Example

The following code example converts the coordinates of a mouse click or stylus tap to screen coordinates and uses the new coordinates in a calculation.

    switch (message)
    {
        case WM_LBUTTONDOWN:
        case WM_RBUTTONDOWN:
            pt.x = LOWORD(lParam);
            pt.y = HIWORD(lParam);
            ClientToScreen( hStatusWnd, &pt );
            SetCapture(hStatusWnd);
            GetWindowRect(hStatusWnd,&drc);
            ptdif.x = pt.x - drc.left;
            ptdif.y = pt.y - drc.top;
            break;
    }

Remarks

The ClientToScreen function replaces the client coordinates in the POINT structure with the screen coordinates. The screen coordinates are relative to the upper-left corner of the screen.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.
Link Library: Coredll.lib, Winmgr.lib.

Share via