dlls/user/painting.c

   1 /*
   2  * Window painting functions
   3  *
   4  * Copyright 1993, 1994, 1995, 2001, 2004 Alexandre Julliard
   5  * Copyright 1999 Alex Korobka
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with this library; if not, write to the Free Software
  19  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  20  */
  21
  22 #include "config.h"
  23 #include "wine/port.h"
  24
  25 #include <stdarg.h>
  26 #include <string.h>
  27
  28 #include "windef.h"
  29 #include "winbase.h"
  30 #include "wingdi.h"
  31 #include "ntstatus.h"
  32 #include "winuser.h"
  33 #include "wine/server.h"
  34 #include "win.h"
  35 #include "user_private.h"
  36 #include "wine/debug.h"
  37
  38 WINE_DEFAULT_DEBUG_CHANNEL(win);
  39
  40
  41 /***********************************************************************
  42  *           dump_rdw_flags
  43  */
  44 static void dump_rdw_flags(UINT flags)
  45 {
  46     TRACE("flags:");
  47     if (flags & RDW_INVALIDATE) TRACE(" RDW_INVALIDATE");
  48     if (flags & RDW_INTERNALPAINT) TRACE(" RDW_INTERNALPAINT");
  49     if (flags & RDW_ERASE) TRACE(" RDW_ERASE");
  50     if (flags & RDW_VALIDATE) TRACE(" RDW_VALIDATE");
  51     if (flags & RDW_NOINTERNALPAINT) TRACE(" RDW_NOINTERNALPAINT");
  52     if (flags & RDW_NOERASE) TRACE(" RDW_NOERASE");
  53     if (flags & RDW_NOCHILDREN) TRACE(" RDW_NOCHILDREN");
  54     if (flags & RDW_ALLCHILDREN) TRACE(" RDW_ALLCHILDREN");
  55     if (flags & RDW_UPDATENOW) TRACE(" RDW_UPDATENOW");
  56     if (flags & RDW_ERASENOW) TRACE(" RDW_ERASENOW");
  57     if (flags & RDW_FRAME) TRACE(" RDW_FRAME");
  58     if (flags & RDW_NOFRAME) TRACE(" RDW_NOFRAME");
  59
  60 #define RDW_FLAGS \
  61     (RDW_INVALIDATE | \
  62     RDW_INTERNALPAINT | \
  63     RDW_ERASE | \
  64     RDW_VALIDATE | \
  65     RDW_NOINTERNALPAINT | \
  66     RDW_NOERASE | \
  67     RDW_NOCHILDREN | \
  68     RDW_ALLCHILDREN | \
  69     RDW_UPDATENOW | \
  70     RDW_ERASENOW | \
  71     RDW_FRAME | \
  72     RDW_NOFRAME)
  73
  74     if (flags & ~RDW_FLAGS) TRACE(" %04x", flags & ~RDW_FLAGS);
  75     TRACE("\n");
  76 #undef RDW_FLAGS
  77 }
  78
  79
  80 /***********************************************************************
  81  *           get_update_region
  82  *
  83  * Return update region (in screen coordinates) for a window.
  84  */
  85 static HRGN get_update_region( HWND hwnd, UINT *flags, HWND *child )
  86 {
  87     HRGN hrgn = 0;
  88     NTSTATUS status;
  89     RGNDATA *data;
  90     size_t size = 256;
  91
  92     do
  93     {
  94         if (!(data = HeapAlloc( GetProcessHeap(), 0, sizeof(*data) + size - 1 )))
  95         {
  96             SetLastError( ERROR_OUTOFMEMORY );
  97             return 0;
  98         }
  99
 100         SERVER_START_REQ( get_update_region )
 101         {
 102             req->window     = hwnd;
 103             req->from_child = child ? *child : 0;
 104             req->flags      = *flags;
 105             wine_server_set_reply( req, data->Buffer, size );
 106             if (!(status = wine_server_call( req )))
 107             {
 108                 size_t reply_size = wine_server_reply_size( reply );
 109                 data->rdh.dwSize   = sizeof(data->rdh);
 110                 data->rdh.iType    = RDH_RECTANGLES;
 111                 data->rdh.nCount   = reply_size / sizeof(RECT);
 112                 data->rdh.nRgnSize = reply_size;
 113                 hrgn = ExtCreateRegion( NULL, size, data );
 114                 if (child) *child = reply->child;
 115                 *flags = reply->flags;
 116             }
 117             else size = reply->total_size;
 118         }
 119         SERVER_END_REQ;
 120         HeapFree( GetProcessHeap(), 0, data );
 121     } while (status == STATUS_BUFFER_OVERFLOW);
 122
 123     if (status) SetLastError( RtlNtStatusToDosError(status) );
 124     return hrgn;
 125 }
 126
 127
 128 /***********************************************************************
 129  *           get_update_flags
 130  *
 131  * Get only the update flags, not the update region.
 132  */
 133 static BOOL get_update_flags( HWND hwnd, HWND *child, UINT *flags )
 134 {
 135     BOOL ret;
 136
 137     SERVER_START_REQ( get_update_region )
 138     {
 139         req->window     = hwnd;
 140         req->from_child = child ? *child : 0;
 141         req->flags      = *flags | UPDATE_NOREGION;
 142         if ((ret = !wine_server_call_err( req )))
 143         {
 144             if (child) *child = reply->child;
 145             *flags = reply->flags;
 146         }
 147     }
 148     SERVER_END_REQ;
 149     return ret;
 150 }
 151
 152
 153 /***********************************************************************
 154  *           redraw_window_rects
 155  *
 156  * Redraw part of a window.
 157  */
 158 static BOOL redraw_window_rects( HWND hwnd, UINT flags, const RECT *rects, UINT count )
 159 {
 160     BOOL ret;
 161
 162     SERVER_START_REQ( redraw_window )
 163     {
 164         req->window = hwnd;
 165         req->flags  = flags;
 166         wine_server_add_data( req, rects, count * sizeof(RECT) );
 167         ret = !wine_server_call_err( req );
 168     }
 169     SERVER_END_REQ;
 170     return ret;
 171 }
 172
 173
 174 /***********************************************************************
 175  *           send_ncpaint
 176  *
 177  * Send a WM_NCPAINT message if needed, and return the resulting update region (in screen coords).
 178  * Helper for erase_now and BeginPaint.
 179  */
 180 static HRGN send_ncpaint( HWND hwnd, HWND *child, UINT *flags )
 181 {
 182     HRGN whole_rgn = get_update_region( hwnd, flags, child );
 183     HRGN client_rgn = 0;
 184
 185     if (child) hwnd = *child;
 186
 187     if (whole_rgn)
 188     {
 189         RECT client, update;
 190         INT type;
 191
 192         /* check if update rgn overlaps with nonclient area */
 193         type = GetRgnBox( whole_rgn, &update );
 194         GetClientRect( hwnd, &client );
 195         MapWindowPoints( hwnd, 0, (POINT *)&client, 2 );
 196
 197         if ((*flags & UPDATE_NONCLIENT) ||
 198             update.left < client.left || update.top < client.top ||
 199             update.right > client.right || update.bottom > client.bottom)
 200         {
 201             client_rgn = CreateRectRgnIndirect( &client );
 202             CombineRgn( client_rgn, client_rgn, whole_rgn, RGN_AND );
 203
 204             /* check if update rgn contains complete nonclient area */
 205             if (type == SIMPLEREGION)
 206             {
 207                 RECT window;
 208                 GetWindowRect( hwnd, &window );
 209                 if (EqualRect( &window, &update ))
 210                 {
 211                     DeleteObject( whole_rgn );
 212                     whole_rgn = (HRGN)1;
 213                 }
 214             }
 215         }
 216         else
 217         {
 218             client_rgn = whole_rgn;
 219             whole_rgn = 0;
 220         }
 221
 222         if (whole_rgn) /* NOTE: WM_NCPAINT allows wParam to be 1 */
 223         {
 224             if (*flags & UPDATE_NONCLIENT) SendMessageW( hwnd, WM_NCPAINT, (WPARAM)whole_rgn, 0 );
 225             if (whole_rgn > (HRGN)1) DeleteObject( whole_rgn );
 226         }
 227     }
 228     return client_rgn;
 229 }
 230
 231
 232 /***********************************************************************
 233  *           send_erase
 234  *
 235  * Send a WM_ERASEBKGND message if needed, and optionally return the DC for painting.
 236  * If a DC is requested, the region is selected into it. In all cases the region is deleted.
 237  * Helper for erase_now and BeginPaint.
 238  */
 239 static BOOL send_erase( HWND hwnd, UINT flags, HRGN client_rgn,
 240                         RECT *clip_rect, HDC *hdc_ret )
 241 {
 242     BOOL need_erase = FALSE;
 243     HDC hdc = 0;
 244     RECT dummy;
 245
 246     if (!clip_rect) clip_rect = &dummy;
 247     if (hdc_ret || (flags & UPDATE_ERASE))
 248     {
 249         UINT dcx_flags = DCX_INTERSECTRGN | DCX_USESTYLE;
 250         if (IsIconic(hwnd)) dcx_flags |= DCX_WINDOW;
 251
 252         if ((hdc = GetDCEx( hwnd, client_rgn, dcx_flags )))
 253         {
 254             INT type = GetClipBox( hdc, clip_rect );
 255
 256             if (flags & UPDATE_ERASE)
 257             {
 258                 /* don't erase if the clip box is empty */
 259                 if (type != NULLREGION)
 260                     need_erase = !SendMessageW( hwnd, WM_ERASEBKGND, (WPARAM)hdc, 0 );
 261             }
 262             if (!hdc_ret)
 263             {
 264                 if (need_erase && hwnd != GetDesktopWindow())  /* FIXME: mark it as needing erase again */
 265                     RedrawWindow( hwnd, clip_rect, 0, RDW_INVALIDATE | RDW_ERASE | RDW_NOCHILDREN );
 266                 USER_Driver->pReleaseDC( hwnd, hdc, TRUE );
 267             }
 268         }
 269
 270         if (hdc_ret) *hdc_ret = hdc;
 271     }
 272     if (!hdc) DeleteObject( client_rgn );
 273     return need_erase;
 274 }
 275
 276
 277 /***********************************************************************
 278  *           erase_now
 279  *
 280  * Implementation of RDW_ERASENOW behavior.
 281  */
 282 static void erase_now( HWND hwnd, UINT rdw_flags )
 283 {
 284     HWND child = 0;
 285     HRGN hrgn;
 286
 287     /* loop while we find a child to repaint */
 288     for (;;)
 289     {
 290         UINT flags = UPDATE_NONCLIENT | UPDATE_ERASE;
 291
 292         if (rdw_flags & RDW_NOCHILDREN) flags |= UPDATE_NOCHILDREN;
 293         else if (rdw_flags & RDW_ALLCHILDREN) flags |= UPDATE_ALLCHILDREN;
 294
 295         if (!(hrgn = send_ncpaint( hwnd, &child, &flags ))) break;
 296         send_erase( child, flags, hrgn, NULL, NULL );
 297
 298         if (!flags) break;  /* nothing more to do */
 299         if (rdw_flags & RDW_NOCHILDREN) break;
 300     }
 301 }
 302
 303
 304 /***********************************************************************
 305  *           update_now
 306  *
 307  * Implementation of RDW_UPDATENOW behavior.
 308  *
 309  * FIXME: Windows uses WM_SYNCPAINT to cut down the number of intertask
 310  * SendMessage() calls. This is a comment inside DefWindowProc() source
 311  * from 16-bit SDK:
 312  *
 313  *   This message avoids lots of inter-app message traffic
 314  *   by switching to the other task and continuing the
 315  *   recursion there.
 316  *
 317  * wParam         = flags
 318  * LOWORD(lParam) = hrgnClip
 319  * HIWORD(lParam) = hwndSkip  (not used; always NULL)
 320  *
 321  */
 322 static void update_now( HWND hwnd, UINT rdw_flags )
 323 {
 324     HWND child = 0;
 325
 326     /* desktop window never gets WM_PAINT, only WM_ERASEBKGND */
 327     if (hwnd == GetDesktopWindow()) erase_now( hwnd, rdw_flags | RDW_NOCHILDREN );
 328
 329     /* loop while we find a child to repaint */
 330     for (;;)
 331     {
 332         UINT flags = UPDATE_PAINT | UPDATE_INTERNALPAINT;
 333
 334         if (rdw_flags & RDW_NOCHILDREN) flags |= UPDATE_NOCHILDREN;
 335         else if (rdw_flags & RDW_ALLCHILDREN) flags |= UPDATE_ALLCHILDREN;
 336
 337         if (!get_update_flags( hwnd, &child, &flags )) break;
 338         if (!flags) break;  /* nothing more to do */
 339
 340         SendMessageW( child, WM_PAINT, 0, 0 );
 341         if (rdw_flags & RDW_NOCHILDREN) break;
 342     }
 343 }
 344
 345
 346 /*************************************************************************
 347  *             fix_caret
 348  *
 349  * Helper for ScrollWindowEx:
 350  * If the return value is 0, no special caret handling is necessary.
 351  * Otherwise the return value is the handle of the window that owns the
 352  * caret. Its caret needs to be hidden during the scroll operation and
 353  * moved to new_caret_pos if move_caret is TRUE.
 354  */
 355 static HWND fix_caret(HWND hWnd, const LPRECT scroll_rect, INT dx, INT dy,
 356                      UINT flags, LPBOOL move_caret, LPPOINT new_caret_pos)
 357 {
 358     GUITHREADINFO info;
 359     RECT rect, mapped_rcCaret;
 360     BOOL hide_caret = FALSE;
 361
 362     if (!GetGUIThreadInfo( GetCurrentThreadId(), &info )) return 0;
 363     if (!info.hwndCaret) return 0;
 364
 365     if (info.hwndCaret == hWnd)
 366     {
 367         /* Move the caret if it's (partially) in the source rectangle */
 368         if (IntersectRect(&rect, scroll_rect, &info.rcCaret))
 369         {
 370             *move_caret = TRUE;
 371             hide_caret = TRUE;
 372             new_caret_pos->x = info.rcCaret.left + dx;
 373             new_caret_pos->y = info.rcCaret.top + dy;
 374         }
 375         else
 376         {
 377             *move_caret = FALSE;
 378
 379             /* Hide the caret if it's in the destination rectangle */
 380             rect = *scroll_rect;
 381             OffsetRect(&rect, dx, dy);
 382             hide_caret = IntersectRect(&rect, &rect, &info.rcCaret);
 383         }
 384     }
 385     else
 386     {
 387         if ((flags & SW_SCROLLCHILDREN) && IsChild(hWnd, info.hwndCaret))
 388         {
 389             *move_caret = FALSE;
 390
 391             /* Hide the caret if it's in the source or in the destination
 392                rectangle */
 393             mapped_rcCaret = info.rcCaret;
 394             MapWindowPoints(info.hwndCaret, hWnd, (LPPOINT)&mapped_rcCaret, 2);
 395
 396             if (IntersectRect(&rect, scroll_rect, &mapped_rcCaret))
 397             {
 398                 hide_caret = TRUE;
 399             }
 400             else
 401             {
 402                 rect = *scroll_rect;
 403                 OffsetRect(&rect, dx, dy);
 404                 hide_caret = IntersectRect(&rect, &rect, &mapped_rcCaret);
 405             }
 406         }
 407         else
 408             return 0;
 409     }
 410
 411     if (hide_caret)
 412     {
 413         HideCaret(info.hwndCaret);
 414         return info.hwndCaret;
 415     }
 416     else
 417         return 0;
 418 }
 419
 420
 421 /***********************************************************************
 422  *              BeginPaint (USER32.@)
 423  */
 424 HDC WINAPI BeginPaint( HWND hwnd, PAINTSTRUCT *lps )
 425 {
 426     HWND full_handle;
 427     HRGN hrgn;
 428     UINT flags = UPDATE_NONCLIENT | UPDATE_ERASE | UPDATE_PAINT | UPDATE_INTERNALPAINT | UPDATE_NOCHILDREN;
 429
 430     if (!lps) return 0;
 431
 432     if (!(full_handle = WIN_IsCurrentThread( hwnd )))
 433     {
 434         if (IsWindow(hwnd))
 435             FIXME( "window %p belongs to other thread\n", hwnd );
 436         return 0;
 437     }
 438     hwnd = full_handle;
 439
 440     HideCaret( hwnd );
 441
 442     if (!(hrgn = send_ncpaint( hwnd, NULL, &flags ))) return 0;
 443
 444     lps->fErase = send_erase( hwnd, flags, hrgn, &lps->rcPaint, &lps->hdc );
 445
 446     TRACE("hdc = %p box = (%ld,%ld - %ld,%ld), fErase = %d\n",
 447           lps->hdc, lps->rcPaint.left, lps->rcPaint.top, lps->rcPaint.right, lps->rcPaint.bottom,
 448           lps->fErase);
 449
 450     return lps->hdc;
 451 }
 452
 453
 454 /***********************************************************************
 455  *              EndPaint (USER32.@)
 456  */
 457 BOOL WINAPI EndPaint( HWND hwnd, const PAINTSTRUCT *lps )
 458 {
 459     if (!lps) return FALSE;
 460     USER_Driver->pReleaseDC( hwnd, lps->hdc, TRUE );
 461     ShowCaret( hwnd );
 462     return TRUE;
 463 }
 464
 465
 466 /***********************************************************************
 467  *              GetDCEx (USER32.@)
 468  */
 469 HDC WINAPI GetDCEx( HWND hwnd, HRGN hrgnClip, DWORD flags )
 470 {
 471     if (!hwnd) hwnd = GetDesktopWindow();
 472     else hwnd = WIN_GetFullHandle( hwnd );
 473
 474     return USER_Driver->pGetDCEx( hwnd, hrgnClip, flags );
 475 }
 476
 477
 478 /***********************************************************************
 479  *              GetDC (USER32.@)
 480  *
 481  * Get a device context.
 482  *
 483  * RETURNS
 484  *      Success: Handle to the device context
 485  *      Failure: NULL.
 486  */
 487 HDC WINAPI GetDC( HWND hwnd )
 488 {
 489     if (!hwnd) return GetDCEx( 0, 0, DCX_CACHE | DCX_WINDOW );
 490     return GetDCEx( hwnd, 0, DCX_USESTYLE );
 491 }
 492
 493
 494 /***********************************************************************
 495  *              GetWindowDC (USER32.@)
 496  */
 497 HDC WINAPI GetWindowDC( HWND hwnd )
 498 {
 499     return GetDCEx( hwnd, 0, DCX_USESTYLE | DCX_WINDOW );
 500 }
 501
 502
 503 /***********************************************************************
 504  *              ReleaseDC (USER32.@)
 505  *
 506  * Release a device context.
 507  *
 508  * RETURNS
 509  *      Success: Non-zero. Resources used by hdc are released.
 510  *      Failure: 0.
 511  */
 512 INT WINAPI ReleaseDC( HWND hwnd, HDC hdc )
 513 {
 514     return USER_Driver->pReleaseDC( hwnd, hdc, FALSE );
 515 }
 516
 517
 518 /**********************************************************************
 519  *              WindowFromDC (USER32.@)
 520  */
 521 HWND WINAPI WindowFromDC( HDC hDC )
 522 {
 523     return USER_Driver->pWindowFromDC( hDC );
 524 }
 525
 526
 527 /***********************************************************************
 528  *              LockWindowUpdate (USER32.@)
 529  */
 530 BOOL WINAPI LockWindowUpdate( HWND hwnd )
 531 {
 532     static HWND lockedWnd;
 533
 534     /* This function is fully implemented by the following patch:
 535      *
 536      * http://www.winehq.org/hypermail/wine-patches/2004/01/0142.html
 537      *
 538      * but in order to work properly, it needs the ability to invalidate
 539      * DCEs in other processes when the lock window is changed, which
 540      * isn't possible yet.
 541      * -mike
 542      */
 543
 544     FIXME("(%p), partial stub!\n",hwnd);
 545
 546     USER_Lock();
 547     if (lockedWnd)
 548     {
 549         if (!hwnd)
 550         {
 551             /* Unlock lockedWnd */
 552             /* FIXME: Do something */
 553         }
 554         else
 555         {
 556             /* Attempted to lock a second window */
 557             /* Return FALSE and do nothing */
 558             USER_Unlock();
 559             return FALSE;
 560         }
 561     }
 562     lockedWnd = hwnd;
 563     USER_Unlock();
 564     return TRUE;
 565 }
 566
 567
 568 /***********************************************************************
 569  *              RedrawWindow (USER32.@)
 570  */
 571 BOOL WINAPI RedrawWindow( HWND hwnd, const RECT *rect, HRGN hrgn, UINT flags )
 572 {
 573     BOOL ret;
 574
 575     if (!hwnd) hwnd = GetDesktopWindow();
 576
 577     if (TRACE_ON(win))
 578     {
 579         if (hrgn)
 580         {
 581             RECT r;
 582             GetRgnBox( hrgn, &r );
 583             TRACE( "%p region %p box %s ", hwnd, hrgn, wine_dbgstr_rect(&r) );
 584         }
 585         else if (rect)
 586             TRACE( "%p rect %s ", hwnd, wine_dbgstr_rect(rect) );
 587         else
 588             TRACE( "%p whole window ", hwnd );
 589
 590         dump_rdw_flags(flags);
 591     }
 592
 593     /* process pending expose events before painting */
 594     if (flags & RDW_UPDATENOW) USER_Driver->pMsgWaitForMultipleObjectsEx( 0, NULL, 0, QS_PAINT, 0 );
 595
 596     if (rect && !hrgn)
 597     {
 598         ret = redraw_window_rects( hwnd, flags, rect, 1 );
 599     }
 600     else if (!hrgn)
 601     {
 602         ret = redraw_window_rects( hwnd, flags, NULL, 0 );
 603     }
 604     else  /* need to build a list of the region rectangles */
 605     {
 606         DWORD size;
 607         RGNDATA *data = NULL;
 608         static const RECT empty;
 609
 610         if (!(size = GetRegionData( hrgn, 0, NULL ))) return FALSE;
 611         if (!(data = HeapAlloc( GetProcessHeap(), 0, size ))) return FALSE;
 612         GetRegionData( hrgn, size, data );
 613         if (!data->rdh.nCount)  /* empty region -> use a single all-zero rectangle */
 614             ret = redraw_window_rects( hwnd, flags, &empty, 1 );
 615         else
 616             ret = redraw_window_rects( hwnd, flags, (const RECT *)data->Buffer, data->rdh.nCount );
 617         HeapFree( GetProcessHeap(), 0, data );
 618     }
 619
 620     if (flags & RDW_UPDATENOW) update_now( hwnd, flags );
 621     else if (flags & RDW_ERASENOW) erase_now( hwnd, flags );
 622
 623     return ret;
 624 }
 625
 626
 627 /***********************************************************************
 628  *              UpdateWindow (USER32.@)
 629  */
 630 BOOL WINAPI UpdateWindow( HWND hwnd )
 631 {
 632     return RedrawWindow( hwnd, NULL, 0, RDW_UPDATENOW | RDW_ALLCHILDREN );
 633 }
 634
 635
 636 /***********************************************************************
 637  *              InvalidateRgn (USER32.@)
 638  */
 639 BOOL WINAPI InvalidateRgn( HWND hwnd, HRGN hrgn, BOOL erase )
 640 {
 641     if (!hwnd)
 642     {
 643         SetLastError( ERROR_INVALID_WINDOW_HANDLE );
 644         return FALSE;
 645     }
 646
 647     return RedrawWindow(hwnd, NULL, hrgn, RDW_INVALIDATE | (erase ? RDW_ERASE : 0) );
 648 }
 649
 650
 651 /***********************************************************************
 652  *              InvalidateRect (USER32.@)
 653  *
 654  * MSDN: if hwnd parameter is NULL, InvalidateRect invalidates and redraws
 655  * all windows and sends WM_ERASEBKGND and WM_NCPAINT.
 656  */
 657 BOOL WINAPI InvalidateRect( HWND hwnd, const RECT *rect, BOOL erase )
 658 {
 659     UINT flags = RDW_INVALIDATE | (erase ? RDW_ERASE : 0);
 660
 661     if (!hwnd)
 662     {
 663         flags = RDW_ALLCHILDREN | RDW_INVALIDATE | RDW_FRAME | RDW_ERASE | RDW_ERASENOW;
 664         rect = NULL;
 665     }
 666
 667     return RedrawWindow( hwnd, rect, 0, flags );
 668 }
 669
 670
 671 /***********************************************************************
 672  *              ValidateRgn (USER32.@)
 673  */
 674 BOOL WINAPI ValidateRgn( HWND hwnd, HRGN hrgn )
 675 {
 676     if (!hwnd)
 677     {
 678         SetLastError( ERROR_INVALID_WINDOW_HANDLE );
 679         return FALSE;
 680     }
 681
 682     return RedrawWindow( hwnd, NULL, hrgn, RDW_VALIDATE );
 683 }
 684
 685
 686 /***********************************************************************
 687  *              ValidateRect (USER32.@)
 688  *
 689  * MSDN: if hwnd parameter is NULL, ValidateRect invalidates and redraws
 690  * all windows and sends WM_ERASEBKGND and WM_NCPAINT.
 691  */
 692 BOOL WINAPI ValidateRect( HWND hwnd, const RECT *rect )
 693 {
 694     UINT flags = RDW_VALIDATE;
 695
 696     if (!hwnd)
 697     {
 698         flags = RDW_ALLCHILDREN | RDW_INVALIDATE | RDW_FRAME | RDW_ERASE | RDW_ERASENOW;
 699         rect = NULL;
 700     }
 701
 702     return RedrawWindow( hwnd, rect, 0, flags );
 703 }
 704
 705
 706 /***********************************************************************
 707  *              GetUpdateRgn (USER32.@)
 708  */
 709 INT WINAPI GetUpdateRgn( HWND hwnd, HRGN hrgn, BOOL erase )
 710 {
 711     INT retval = ERROR;
 712     UINT flags = UPDATE_NOCHILDREN;
 713     HRGN update_rgn;
 714
 715     if (erase) flags |= UPDATE_NONCLIENT | UPDATE_ERASE;
 716
 717     if ((update_rgn = send_ncpaint( hwnd, NULL, &flags )))
 718     {
 719         POINT offset;
 720
 721         retval = CombineRgn( hrgn, update_rgn, 0, RGN_COPY );
 722         send_erase( hwnd, flags, update_rgn, NULL, NULL );
 723         /* map region to client coordinates */
 724         offset.x = offset.y = 0;
 725         ScreenToClient( hwnd, &offset );
 726         OffsetRgn( hrgn, offset.x, offset.y );
 727     }
 728     return retval;
 729 }
 730
 731
 732 /***********************************************************************
 733  *              GetUpdateRect (USER32.@)
 734  */
 735 BOOL WINAPI GetUpdateRect( HWND hwnd, LPRECT rect, BOOL erase )
 736 {
 737     UINT flags = UPDATE_NOCHILDREN;
 738     HRGN update_rgn;
 739
 740     if (erase) flags |= UPDATE_NONCLIENT | UPDATE_ERASE;
 741
 742     if (!(update_rgn = send_ncpaint( hwnd, NULL, &flags ))) return FALSE;
 743
 744     if (rect)
 745     {
 746         if (GetRgnBox( update_rgn, rect ) != NULLREGION)
 747         {
 748             HDC hdc = GetDCEx( hwnd, 0, DCX_USESTYLE );
 749             MapWindowPoints( 0, hwnd, (LPPOINT)rect, 2 );
 750             DPtoLP( hdc, (LPPOINT)rect, 2 );
 751             ReleaseDC( hwnd, hdc );
 752         }
 753     }
 754     send_erase( hwnd, flags, update_rgn, NULL, NULL );
 755
 756     /* check if we still have an update region */
 757     flags = UPDATE_PAINT | UPDATE_NOCHILDREN;
 758     return (get_update_flags( hwnd, NULL, &flags ) && (flags & UPDATE_PAINT));
 759 }
 760
 761
 762 /***********************************************************************
 763  *              ExcludeUpdateRgn (USER32.@)
 764  */
 765 INT WINAPI ExcludeUpdateRgn( HDC hdc, HWND hwnd )
 766 {
 767     HRGN update_rgn = CreateRectRgn( 0, 0, 0, 0 );
 768     INT ret = GetUpdateRgn( hwnd, update_rgn, FALSE );
 769
 770     if (ret != ERROR)
 771     {
 772         POINT pt;
 773
 774         GetDCOrgEx( hdc, &pt );
 775         MapWindowPoints( 0, hwnd, &pt, 1 );
 776         OffsetRgn( update_rgn, -pt.x, -pt.y );
 777         ret = ExtSelectClipRgn( hdc, update_rgn, RGN_DIFF );
 778         DeleteObject( update_rgn );
 779     }
 780     return ret;
 781 }
 782
 783
 784 /*************************************************************************
 785  *              ScrollWindowEx (USER32.@)
 786  *
 787  * Note: contrary to what the doc says, pixels that are scrolled from the
 788  *      outside of clipRect to the inside are NOT painted.
 789  *
 790  */
 791 INT WINAPI ScrollWindowEx( HWND hwnd, INT dx, INT dy,
 792                            const RECT *rect, const RECT *clipRect,
 793                            HRGN hrgnUpdate, LPRECT rcUpdate,
 794                            UINT flags )
 795 {
 796     INT   retVal = NULLREGION;
 797     BOOL  bOwnRgn = TRUE;
 798     BOOL  bUpdate = (rcUpdate || hrgnUpdate || flags & (SW_INVALIDATE | SW_ERASE));
 799     int rdw_flags;
 800     HRGN  hrgnTemp;
 801     HRGN  hrgnWinupd = 0;
 802     HDC   hDC;
 803     RECT  rc, cliprc;
 804     HWND hwndCaret = NULL;
 805     BOOL moveCaret = FALSE;
 806     POINT newCaretPos;
 807
 808     TRACE( "%p, %d,%d hrgnUpdate=%p rcUpdate = %p %s %04x\n",
 809            hwnd, dx, dy, hrgnUpdate, rcUpdate, wine_dbgstr_rect(rect), flags );
 810     TRACE( "clipRect = %s\n", wine_dbgstr_rect(clipRect));
 811     if( flags & ~( SW_SCROLLCHILDREN | SW_INVALIDATE | SW_ERASE))
 812         FIXME("some flags (%04x) are unhandled\n", flags);
 813
 814     rdw_flags = (flags & SW_ERASE) && (flags & SW_INVALIDATE) ?
 815                                 RDW_INVALIDATE | RDW_ERASE  : RDW_INVALIDATE ;
 816
 817     if (!WIN_IsWindowDrawable( hwnd, TRUE )) return ERROR;
 818     hwnd = WIN_GetFullHandle( hwnd );
 819
 820     GetClientRect(hwnd, &rc);
 821     if (rect) IntersectRect(&rc, &rc, rect);
 822
 823     if (clipRect) IntersectRect(&cliprc,&rc,clipRect);
 824     else cliprc = rc;
 825
 826     if( hrgnUpdate ) bOwnRgn = FALSE;
 827     else if( bUpdate ) hrgnUpdate = CreateRectRgn( 0, 0, 0, 0 );
 828
 829     newCaretPos.x = newCaretPos.y = 0;
 830
 831     if( !IsRectEmpty(&cliprc) && (dx || dy)) {
 832         DWORD dcxflags = DCX_CACHE;
 833         DWORD style = GetWindowLongW( hwnd, GWL_STYLE );
 834
 835         hwndCaret = fix_caret(hwnd, &rc, dx, dy, flags, &moveCaret, &newCaretPos);
 836
 837         if( style & WS_CLIPSIBLINGS) dcxflags |= DCX_CLIPSIBLINGS;
 838         if( GetClassLongW( hwnd, GCL_STYLE ) & CS_PARENTDC)
 839             dcxflags |= DCX_PARENTCLIP;
 840         if( !(flags & SW_SCROLLCHILDREN) && (style & WS_CLIPCHILDREN))
 841             dcxflags |= DCX_CLIPCHILDREN;
 842         hDC = GetDCEx( hwnd, 0, dcxflags);
 843         if (hDC)
 844         {
 845             ScrollDC( hDC, dx, dy, &rc, &cliprc, hrgnUpdate, rcUpdate );
 846
 847             ReleaseDC( hwnd, hDC );
 848
 849             if (!bUpdate)
 850                 RedrawWindow( hwnd, NULL, hrgnUpdate, rdw_flags);
 851         }
 852
 853         /* If the windows has an update region, this must be
 854          * scrolled as well. Keep a copy in hrgnWinupd
 855          * to be added to hrngUpdate at the end. */
 856         hrgnTemp = CreateRectRgn( 0, 0, 0, 0 );
 857         retVal = GetUpdateRgn( hwnd, hrgnTemp, FALSE );
 858         if (retVal != NULLREGION)
 859         {
 860             HRGN hrgnClip = CreateRectRgnIndirect(&cliprc);
 861             if( !bOwnRgn) {
 862                 hrgnWinupd = CreateRectRgn( 0, 0, 0, 0);
 863                 CombineRgn( hrgnWinupd, hrgnTemp, 0, RGN_COPY);
 864             }
 865             OffsetRgn( hrgnTemp, dx, dy );
 866             CombineRgn( hrgnTemp, hrgnTemp, hrgnClip, RGN_AND );
 867             if( !bOwnRgn)
 868                 CombineRgn( hrgnWinupd, hrgnWinupd, hrgnTemp, RGN_OR );
 869             RedrawWindow( hwnd, NULL, hrgnTemp, rdw_flags);
 870             DeleteObject( hrgnClip );
 871         }
 872         DeleteObject( hrgnTemp );
 873     } else {
 874         /* nothing was scrolled */
 875         if( !bOwnRgn)
 876             SetRectRgn( hrgnUpdate, 0, 0, 0, 0 );
 877         SetRectEmpty( rcUpdate);
 878     }
 879
 880     if( flags & SW_SCROLLCHILDREN )
 881     {
 882         HWND *list = WIN_ListChildren( hwnd );
 883         if (list)
 884         {
 885             int i;
 886             RECT r, dummy;
 887             for (i = 0; list[i]; i++)
 888             {
 889                 GetWindowRect( list[i], &r );
 890                 MapWindowPoints( 0, hwnd, (POINT *)&r, 2 );
 891                 if (!rect || IntersectRect(&dummy, &r, rect))
 892                     SetWindowPos( list[i], 0, r.left + dx, r.top  + dy, 0, 0,
 893                                   SWP_NOZORDER | SWP_NOSIZE | SWP_NOACTIVATE |
 894                                   SWP_NOREDRAW | SWP_DEFERERASE );
 895             }
 896             HeapFree( GetProcessHeap(), 0, list );
 897         }
 898     }
 899
 900     if( flags & (SW_INVALIDATE | SW_ERASE) )
 901         RedrawWindow( hwnd, NULL, hrgnUpdate, rdw_flags |
 902                       ((flags & SW_SCROLLCHILDREN) ? RDW_ALLCHILDREN : 0 ) );
 903
 904     if( hrgnWinupd) {
 905         CombineRgn( hrgnUpdate, hrgnUpdate, hrgnWinupd, RGN_OR);
 906         DeleteObject( hrgnWinupd);
 907     }
 908
 909     if( hwndCaret ) {
 910         if ( moveCaret ) SetCaretPos( newCaretPos.x, newCaretPos.y );
 911         ShowCaret(hwndCaret);
 912     }
 913
 914     if( bOwnRgn && hrgnUpdate ) DeleteObject( hrgnUpdate );
 915
 916     return retVal;
 917 }
 918
 919
 920 /*************************************************************************
 921  *              ScrollWindow (USER32.@)
 922  *
 923  */
 924 BOOL WINAPI ScrollWindow( HWND hwnd, INT dx, INT dy,
 925                           const RECT *rect, const RECT *clipRect )
 926 {
 927     return (ERROR != ScrollWindowEx( hwnd, dx, dy, rect, clipRect, 0, NULL,
 928                                      (rect ? 0 : SW_SCROLLCHILDREN) |
 929                                      SW_INVALIDATE | SW_ERASE ));
 930 }
 931
 932
 933 /*************************************************************************
 934  *              ScrollDC (USER32.@)
 935  *
 936  * dx, dy, lprcScroll and lprcClip are all in logical coordinates (msdn is
 937  * wrong) hrgnUpdate is returned in device coordinates with rcUpdate in
 938  * logical coordinates.
 939  */
 940 BOOL WINAPI ScrollDC( HDC hdc, INT dx, INT dy, const RECT *lprcScroll,
 941                       const RECT *lprcClip, HRGN hrgnUpdate, LPRECT lprcUpdate )
 942
 943 {
 944     return USER_Driver->pScrollDC( hdc, dx, dy, lprcScroll, lprcClip, hrgnUpdate, lprcUpdate );
 945 }