/* * Scrollbar control * * Copyright 1993 Martin Ayotte * Copyright 1994, 1996 Alexandre Julliard * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA */ #include #include "windef.h" #include "winbase.h" #include "wingdi.h" #include "controls.h" #include "win.h" #include "wine/debug.h" #include "user_private.h" WINE_DEFAULT_DEBUG_CHANNEL(scroll); /* data for a single scroll bar */ typedef struct { INT curVal; /* Current scroll-bar value */ INT minVal; /* Minimum scroll-bar value */ INT maxVal; /* Maximum scroll-bar value */ INT page; /* Page size of scroll bar (Win32) */ UINT flags; /* EnableScrollBar flags */ BOOL painted; /* Whether the scroll bar is painted by DefWinProc() */ } SCROLLBAR_INFO, *LPSCROLLBAR_INFO; /* data for window that has (one or two) scroll bars */ typedef struct { SCROLLBAR_INFO horz; SCROLLBAR_INFO vert; } WINSCROLLBAR_INFO, *LPWINSCROLLBAR_INFO; typedef struct { DWORD magic; SCROLLBAR_INFO info; } SCROLLBAR_WNDDATA; #define SCROLLBAR_MAGIC 0x5c6011ba /* Minimum size of the rectangle between the arrows */ #define SCROLL_MIN_RECT 4 /* Minimum size of the thumb in pixels */ #define SCROLL_MIN_THUMB 8 /* Overlap between arrows and thumb */ #define SCROLL_ARROW_THUMB_OVERLAP 0 /* Delay (in ms) before first repetition when holding the button down */ #define SCROLL_FIRST_DELAY 200 /* Delay (in ms) between scroll repetitions */ #define SCROLL_REPEAT_DELAY 50 /* Scroll timer id */ #define SCROLL_TIMER 0 /* What to do after SCROLL_SetScrollInfo() */ #define SA_SSI_HIDE 0x0001 #define SA_SSI_SHOW 0x0002 #define SA_SSI_REFRESH 0x0004 #define SA_SSI_REPAINT_ARROWS 0x0008 /* Scroll Bar tracking information */ static struct SCROLL_TRACKING_INFO g_tracking_info; /* Is the moving thumb being displayed? */ static BOOL SCROLL_MovingThumb = FALSE; /* Local functions */ static BOOL SCROLL_ShowScrollBar( HWND hwnd, INT nBar, BOOL fShowH, BOOL fShowV ); static INT SCROLL_SetScrollInfo( HWND hwnd, INT nBar, const SCROLLINFO *info, BOOL bRedraw ); /********************************************************************* * scrollbar class descriptor */ const struct builtin_class_descr SCROLL_builtin_class = { L"ScrollBar", /* name */ CS_DBLCLKS | CS_VREDRAW | CS_HREDRAW | CS_PARENTDC, /* style */ WINPROC_SCROLLBAR, /* proc */ sizeof(SCROLLBAR_WNDDATA), /* extra */ IDC_ARROW, /* cursor */ 0 /* brush */ }; /*********************************************************************** * SCROLL_ScrollInfoValid * * Determine if the supplied SCROLLINFO struct is valid. * info [in] The SCROLLINFO struct to be tested */ static inline BOOL SCROLL_ScrollInfoValid( LPCSCROLLINFO info ) { return !(info->fMask & ~(SIF_ALL | SIF_DISABLENOSCROLL) || (info->cbSize != sizeof(*info) && info->cbSize != sizeof(*info) - sizeof(info->nTrackPos))); } /*********************************************************************** * SCROLL_GetInternalInfo * Returns pointer to internal SCROLLBAR_INFO structure for nBar * or NULL if failed (f.i. scroll bar does not exist yet) * If alloc is TRUE and the struct does not exist yet, create it. */ static SCROLLBAR_INFO *SCROLL_GetInternalInfo( HWND hwnd, INT nBar, BOOL alloc ) { SCROLLBAR_INFO *infoPtr = NULL; WND *wndPtr = WIN_GetPtr( hwnd ); if (!wndPtr || wndPtr == WND_OTHER_PROCESS || wndPtr == WND_DESKTOP) return NULL; switch(nBar) { case SB_HORZ: if (wndPtr->pScroll) infoPtr = &((LPWINSCROLLBAR_INFO)wndPtr->pScroll)->horz; break; case SB_VERT: if (wndPtr->pScroll) infoPtr = &((LPWINSCROLLBAR_INFO)wndPtr->pScroll)->vert; break; case SB_CTL: if (wndPtr->cbWndExtra >= sizeof(SCROLLBAR_WNDDATA)) { SCROLLBAR_WNDDATA *data = (SCROLLBAR_WNDDATA*)wndPtr->wExtra; if (data->magic == SCROLLBAR_MAGIC) infoPtr = &data->info; } if (!infoPtr) WARN("window is not a scrollbar control\n"); break; case SB_BOTH: WARN("with SB_BOTH\n"); break; } if (!infoPtr && alloc) { WINSCROLLBAR_INFO *winInfoPtr; if (nBar != SB_HORZ && nBar != SB_VERT) WARN("Cannot initialize nBar=%d\n",nBar); else if ((winInfoPtr = HeapAlloc( GetProcessHeap(), 0, sizeof(WINSCROLLBAR_INFO) ))) { /* Set default values */ winInfoPtr->horz.minVal = 0; winInfoPtr->horz.curVal = 0; winInfoPtr->horz.page = 0; /* From MSDN and our own tests: * max for a standard scroll bar is 100 by default. */ winInfoPtr->horz.maxVal = 100; winInfoPtr->horz.flags = ESB_ENABLE_BOTH; winInfoPtr->vert = winInfoPtr->horz; wndPtr->pScroll = winInfoPtr; infoPtr = nBar == SB_HORZ ? &winInfoPtr->horz : &winInfoPtr->vert; } } WIN_ReleasePtr( wndPtr ); return infoPtr; } /*********************************************************************** * SCROLL_GetScrollBarRect * * Compute the scroll bar rectangle, in drawing coordinates (i.e. client * coords for SB_CTL, window coords for SB_VERT and SB_HORZ). * 'arrowSize' returns the width or height of an arrow (depending on * the orientation of the scrollbar), 'thumbSize' returns the size of * the thumb, and 'thumbPos' returns the position of the thumb * relative to the left or to the top. * Return TRUE if the scrollbar is vertical, FALSE if horizontal. */ static BOOL SCROLL_GetScrollBarRect( HWND hwnd, INT nBar, RECT *lprect, INT *arrowSize, INT *thumbSize, INT *thumbPos ) { INT pixels, min_thumb_size; BOOL vertical; WND *wndPtr = WIN_GetPtr( hwnd ); if (!wndPtr || wndPtr == WND_OTHER_PROCESS || wndPtr == WND_DESKTOP) return FALSE; switch(nBar) { case SB_HORZ: WIN_GetRectangles( hwnd, COORDS_WINDOW, NULL, lprect ); lprect->top = lprect->bottom; lprect->bottom += GetSystemMetrics(SM_CYHSCROLL); if(wndPtr->dwStyle & WS_VSCROLL) lprect->right++; vertical = FALSE; break; case SB_VERT: WIN_GetRectangles( hwnd, COORDS_WINDOW, NULL, lprect ); if((wndPtr->dwExStyle & WS_EX_LEFTSCROLLBAR) != 0) { lprect->right = lprect->left; lprect->left -= GetSystemMetrics(SM_CXVSCROLL); } else { lprect->left = lprect->right; lprect->right += GetSystemMetrics(SM_CXVSCROLL); } if(wndPtr->dwStyle & WS_HSCROLL) lprect->bottom++; vertical = TRUE; break; case SB_CTL: GetClientRect( hwnd, lprect ); vertical = ((wndPtr->dwStyle & SBS_VERT) != 0); break; default: WIN_ReleasePtr( wndPtr ); return FALSE; } if (vertical) pixels = lprect->bottom - lprect->top; else pixels = lprect->right - lprect->left; if (pixels <= 2*GetSystemMetrics(SM_CXVSCROLL) + SCROLL_MIN_RECT) { if (pixels > SCROLL_MIN_RECT) *arrowSize = (pixels - SCROLL_MIN_RECT) / 2; else *arrowSize = 0; *thumbPos = *thumbSize = 0; } else { SCROLLBAR_INFO *info = SCROLL_GetInternalInfo( hwnd, nBar, TRUE ); if (!info) { WARN("called for missing scroll bar\n"); WIN_ReleasePtr( wndPtr ); return FALSE; } *arrowSize = GetSystemMetrics(SM_CXVSCROLL); pixels -= (2 * (GetSystemMetrics(SM_CXVSCROLL) - SCROLL_ARROW_THUMB_OVERLAP)); if (info->page) { *thumbSize = MulDiv(pixels,info->page,(info->maxVal-info->minVal+1)); min_thumb_size = MulDiv(SCROLL_MIN_THUMB, GetDpiForWindow(hwnd), 96); if (*thumbSize < min_thumb_size) *thumbSize = min_thumb_size; } else *thumbSize = GetSystemMetrics(SM_CXVSCROLL); if (((pixels -= *thumbSize ) < 0) || ((info->flags & ESB_DISABLE_BOTH) == ESB_DISABLE_BOTH)) { /* Rectangle too small or scrollbar disabled -> no thumb */ *thumbPos = *thumbSize = 0; } else { INT max = info->maxVal - max( info->page-1, 0 ); if (info->minVal >= max) *thumbPos = *arrowSize - SCROLL_ARROW_THUMB_OVERLAP; else *thumbPos = *arrowSize - SCROLL_ARROW_THUMB_OVERLAP + MulDiv(pixels, (info->curVal-info->minVal),(max - info->minVal)); } } WIN_ReleasePtr( wndPtr ); return vertical; } static void SCROLL_GetScrollBarDrawInfo( HWND hwnd, INT bar, const struct SCROLL_TRACKING_INFO *tracking_info, RECT *rect, INT *arrow_size, INT *thumb_size, INT *thumb_pos, BOOL *vertical ) { INT pos, max_size; if (bar == SB_CTL && GetWindowLongW( hwnd, GWL_STYLE ) & (SBS_SIZEGRIP | SBS_SIZEBOX)) { GetClientRect( hwnd, rect ); *arrow_size = 0; *thumb_pos = 0; *thumb_size = 0; *vertical = FALSE; return; } *vertical = SCROLL_GetScrollBarRect( hwnd, bar, rect, arrow_size, thumb_size, thumb_pos ); if (SCROLL_MovingThumb && tracking_info->win == hwnd && tracking_info->bar == bar) { max_size = *vertical ? rect->bottom - rect->top : rect->right - rect->left; max_size -= *arrow_size - SCROLL_ARROW_THUMB_OVERLAP + *thumb_size; pos = tracking_info->thumb_pos; if (pos < *arrow_size - SCROLL_ARROW_THUMB_OVERLAP) pos = *arrow_size - SCROLL_ARROW_THUMB_OVERLAP; else if (pos > max_size) pos = max_size; *thumb_pos = pos; } } /*********************************************************************** * SCROLL_GetThumbVal * * Compute the current scroll position based on the thumb position in pixels * from the top of the scroll-bar. */ static UINT SCROLL_GetThumbVal( HWND hwnd, SCROLLBAR_INFO *infoPtr, RECT *rect, BOOL vertical, INT pos ) { INT thumbSize, minThumbSize; INT pixels = vertical ? rect->bottom-rect->top : rect->right-rect->left; INT range; if ((pixels -= 2*(GetSystemMetrics(SM_CXVSCROLL) - SCROLL_ARROW_THUMB_OVERLAP)) <= 0) return infoPtr->minVal; if (infoPtr->page) { thumbSize = MulDiv(pixels,infoPtr->page,(infoPtr->maxVal-infoPtr->minVal+1)); minThumbSize = MulDiv(SCROLL_MIN_THUMB, GetDpiForWindow(hwnd), 96); if (thumbSize < minThumbSize) thumbSize = minThumbSize; } else thumbSize = GetSystemMetrics(SM_CXVSCROLL); if ((pixels -= thumbSize) <= 0) return infoPtr->minVal; pos = max( 0, pos - (GetSystemMetrics(SM_CXVSCROLL) - SCROLL_ARROW_THUMB_OVERLAP) ); if (pos > pixels) pos = pixels; if (!infoPtr->page) range = infoPtr->maxVal - infoPtr->minVal; else range = infoPtr->maxVal - infoPtr->minVal - infoPtr->page + 1; return infoPtr->minVal + MulDiv(pos, range, pixels); } /*********************************************************************** * SCROLL_PtInRectEx */ static BOOL SCROLL_PtInRectEx( LPRECT lpRect, POINT pt, BOOL vertical ) { RECT rect = *lpRect; int scrollbarWidth; /* Pad hit rect to allow mouse to be dragged outside of scrollbar and * still be considered in the scrollbar. */ if (vertical) { scrollbarWidth = lpRect->right - lpRect->left; InflateRect(&rect, scrollbarWidth * 8, scrollbarWidth * 2); } else { scrollbarWidth = lpRect->bottom - lpRect->top; InflateRect(&rect, scrollbarWidth * 2, scrollbarWidth * 8); } return PtInRect( &rect, pt ); } /*********************************************************************** * SCROLL_ClipPos */ static POINT SCROLL_ClipPos( LPRECT lpRect, POINT pt ) { if( pt.x < lpRect->left ) pt.x = lpRect->left; else if( pt.x > lpRect->right ) pt.x = lpRect->right; if( pt.y < lpRect->top ) pt.y = lpRect->top; else if( pt.y > lpRect->bottom ) pt.y = lpRect->bottom; return pt; } /*********************************************************************** * SCROLL_HitTest * * Scroll-bar hit testing (don't confuse this with WM_NCHITTEST!). */ static enum SCROLL_HITTEST SCROLL_HitTest( HWND hwnd, INT nBar, POINT pt, BOOL bDragging ) { INT arrowSize, thumbSize, thumbPos; RECT rect; BOOL vertical = SCROLL_GetScrollBarRect( hwnd, nBar, &rect, &arrowSize, &thumbSize, &thumbPos ); if ( (bDragging && !SCROLL_PtInRectEx( &rect, pt, vertical )) || (!PtInRect( &rect, pt )) ) return SCROLL_NOWHERE; if (vertical) { if (pt.y < rect.top + arrowSize) return SCROLL_TOP_ARROW; if (pt.y >= rect.bottom - arrowSize) return SCROLL_BOTTOM_ARROW; if (!thumbPos) return SCROLL_TOP_RECT; pt.y -= rect.top; if (pt.y < thumbPos) return SCROLL_TOP_RECT; if (pt.y >= thumbPos + thumbSize) return SCROLL_BOTTOM_RECT; } else /* horizontal */ { if (pt.x < rect.left + arrowSize) return SCROLL_TOP_ARROW; if (pt.x >= rect.right - arrowSize) return SCROLL_BOTTOM_ARROW; if (!thumbPos) return SCROLL_TOP_RECT; pt.x -= rect.left; if (pt.x < thumbPos) return SCROLL_TOP_RECT; if (pt.x >= thumbPos + thumbSize) return SCROLL_BOTTOM_RECT; } return SCROLL_THUMB; } /*********************************************************************** * SCROLL_DrawArrows * * Draw the scroll bar arrows. */ static void SCROLL_DrawArrows( HDC hdc, SCROLLBAR_INFO *infoPtr, RECT *rect, INT arrowSize, BOOL vertical, BOOL top_pressed, BOOL bottom_pressed ) { RECT r; r = *rect; if( vertical ) r.bottom = r.top + arrowSize; else r.right = r.left + arrowSize; DrawFrameControl( hdc, &r, DFC_SCROLL, (vertical ? DFCS_SCROLLUP : DFCS_SCROLLLEFT) | (top_pressed ? (DFCS_PUSHED | DFCS_FLAT) : 0 ) | (infoPtr->flags&ESB_DISABLE_LTUP ? DFCS_INACTIVE : 0 ) ); r = *rect; if( vertical ) r.top = r.bottom-arrowSize; else r.left = r.right-arrowSize; DrawFrameControl( hdc, &r, DFC_SCROLL, (vertical ? DFCS_SCROLLDOWN : DFCS_SCROLLRIGHT) | (bottom_pressed ? (DFCS_PUSHED | DFCS_FLAT) : 0 ) | (infoPtr->flags&ESB_DISABLE_RTDN ? DFCS_INACTIVE : 0) ); } /*********************************************************************** * SCROLL_DrawInterior * * Draw the scroll bar interior (everything except the arrows). */ static void SCROLL_DrawInterior( HWND hwnd, HDC hdc, INT nBar, RECT *rect, INT arrowSize, INT thumbSize, INT thumbPos, UINT flags, BOOL vertical, BOOL top_selected, BOOL bottom_selected ) { RECT r; HPEN hSavePen; HBRUSH hSaveBrush,hBrush; /* Select the correct brush and pen */ /* Only scrollbar controls send WM_CTLCOLORSCROLLBAR. * The window-owned scrollbars need to call DEFWND_ControlColor * to correctly setup default scrollbar colors */ if (nBar == SB_CTL) { hBrush = (HBRUSH)SendMessageW( GetParent(hwnd), WM_CTLCOLORSCROLLBAR, (WPARAM)hdc,(LPARAM)hwnd); } else { hBrush = DEFWND_ControlColor( hdc, CTLCOLOR_SCROLLBAR ); } hSavePen = SelectObject( hdc, SYSCOLOR_GetPen(COLOR_WINDOWFRAME) ); hSaveBrush = SelectObject( hdc, hBrush ); /* Calculate the scroll rectangle */ r = *rect; if (vertical) { r.top += arrowSize - SCROLL_ARROW_THUMB_OVERLAP; r.bottom -= (arrowSize - SCROLL_ARROW_THUMB_OVERLAP); } else { r.left += arrowSize - SCROLL_ARROW_THUMB_OVERLAP; r.right -= (arrowSize - SCROLL_ARROW_THUMB_OVERLAP); } /* Draw the scroll bar frame */ /* Draw the scroll rectangles and thumb */ if (!thumbPos) /* No thumb to draw */ { PatBlt( hdc, r.left, r.top, r.right - r.left, r.bottom - r.top, PATCOPY ); /* cleanup and return */ SelectObject( hdc, hSavePen ); SelectObject( hdc, hSaveBrush ); return; } if (vertical) { PatBlt( hdc, r.left, r.top, r.right - r.left, thumbPos - (arrowSize - SCROLL_ARROW_THUMB_OVERLAP), top_selected ? 0x0f0000 : PATCOPY ); r.top += thumbPos - (arrowSize - SCROLL_ARROW_THUMB_OVERLAP); PatBlt( hdc, r.left, r.top + thumbSize, r.right - r.left, r.bottom - r.top - thumbSize, bottom_selected ? 0x0f0000 : PATCOPY ); r.bottom = r.top + thumbSize; } else /* horizontal */ { PatBlt( hdc, r.left, r.top, thumbPos - (arrowSize - SCROLL_ARROW_THUMB_OVERLAP), r.bottom - r.top, top_selected ? 0x0f0000 : PATCOPY ); r.left += thumbPos - (arrowSize - SCROLL_ARROW_THUMB_OVERLAP); PatBlt( hdc, r.left + thumbSize, r.top, r.right - r.left - thumbSize, r.bottom - r.top, bottom_selected ? 0x0f0000 : PATCOPY ); r.right = r.left + thumbSize; } /* Draw the thumb */ SelectObject( hdc, GetSysColorBrush(COLOR_BTNFACE) ); Rectangle( hdc, r.left+1, r.top+1, r.right-1, r.bottom-1 ); DrawEdge( hdc, &r, EDGE_RAISED, BF_RECT ); /* cleanup */ SelectObject( hdc, hSavePen ); SelectObject( hdc, hSaveBrush ); } void WINAPI USER_ScrollBarDraw( HWND hwnd, HDC hdc, INT nBar, enum SCROLL_HITTEST hit_test, const struct SCROLL_TRACKING_INFO *tracking_info, BOOL arrows, BOOL interior, RECT *rect, INT arrowSize, INT thumbPos, INT thumbSize, BOOL vertical ) { SCROLLBAR_INFO *infoPtr; if (nBar == SB_CTL) { DWORD style = GetWindowLongW( hwnd, GWL_STYLE ); if (style & SBS_SIZEGRIP) { RECT rc = *rect; FillRect( hdc, &rc, GetSysColorBrush( COLOR_BTNFACE ) ); rc.left = max( rc.left, rc.right - GetSystemMetrics( SM_CXVSCROLL ) - 1 ); rc.top = max( rc.top, rc.bottom - GetSystemMetrics( SM_CYHSCROLL ) - 1 ); DrawFrameControl( hdc, &rc, DFC_SCROLL, DFCS_SCROLLSIZEGRIP ); return; } if (style & SBS_SIZEBOX) { FillRect( hdc, rect, GetSysColorBrush( COLOR_BTNFACE ) ); return; } } if (!(infoPtr = SCROLL_GetInternalInfo( hwnd, nBar, TRUE ))) return; /* Draw the arrows */ if (arrows && arrowSize) { if (vertical == tracking_info->vertical && GetCapture() == hwnd) SCROLL_DrawArrows( hdc, infoPtr, rect, arrowSize, vertical, hit_test == tracking_info->hit_test && hit_test == SCROLL_TOP_ARROW, hit_test == tracking_info->hit_test && hit_test == SCROLL_BOTTOM_ARROW ); else SCROLL_DrawArrows( hdc, infoPtr, rect, arrowSize, vertical, FALSE, FALSE ); } if (interior) { if (vertical == tracking_info->vertical && GetCapture() == hwnd) { SCROLL_DrawInterior( hwnd, hdc, nBar, rect, arrowSize, thumbSize, thumbPos, infoPtr->flags, vertical, hit_test == tracking_info->hit_test && hit_test == SCROLL_TOP_RECT, hit_test == tracking_info->hit_test && hit_test == SCROLL_BOTTOM_RECT ); } else { SCROLL_DrawInterior( hwnd, hdc, nBar, rect, arrowSize, thumbSize, thumbPos, infoPtr->flags, vertical, FALSE, FALSE ); } } /* if scroll bar has focus, reposition the caret */ if(hwnd==GetFocus() && (nBar==SB_CTL)) { if (!vertical) { SetCaretPos(thumbPos + 1, rect->top + 1); } else { SetCaretPos(rect->top + 1, thumbPos + 1); } } } void WINAPI SCROLL_SetStandardScrollPainted( HWND hwnd, INT bar, BOOL painted ) { LPSCROLLBAR_INFO info; if (bar != SB_HORZ && bar != SB_VERT) return; info = SCROLL_GetInternalInfo( hwnd, bar, FALSE ); if (info) info->painted = painted; } static BOOL SCROLL_IsStandardScrollPainted( HWND hwnd, INT bar ) { LPSCROLLBAR_INFO info; if (bar != SB_HORZ && bar != SB_VERT) return FALSE; info = SCROLL_GetInternalInfo( hwnd, bar, FALSE ); return info ? info->painted : FALSE; } /*********************************************************************** * SCROLL_DrawScrollBar * * Redraw the whole scrollbar. */ void SCROLL_DrawScrollBar( HWND hwnd, HDC hdc, INT bar, enum SCROLL_HITTEST hit_test, const struct SCROLL_TRACKING_INFO *tracking_info, BOOL draw_arrows, BOOL draw_interior ) { INT arrow_size, thumb_size, thumb_pos; RECT rect, clip_box, intersect; BOOL vertical; DWORD style; if (!(hwnd = WIN_GetFullHandle( hwnd ))) return; style = GetWindowLongW( hwnd, GWL_STYLE ); if ((bar == SB_VERT && !(style & WS_VSCROLL)) || (bar == SB_HORZ && !(style & WS_HSCROLL))) return; if (!WIN_IsWindowDrawable( hwnd, FALSE )) return; SCROLL_GetScrollBarDrawInfo( hwnd, bar, tracking_info, &rect, &arrow_size, &thumb_size, &thumb_pos, &vertical ); /* do not draw if the scrollbar rectangle is empty */ if (IsRectEmpty( &rect )) return; TRACE("hwnd %p, hdc %p, bar %d, hit_test %d, tracking_info(win %p, bar %d, thumb_pos %d, " "track_pos %d, vertical %d, hit_test %d), draw_arrows %d, draw_interior %d, rect %s, " "arrow_size %d, thumb_pos %d, thumb_val %d, vertical %d, captured window %p\n", hwnd, hdc, bar, hit_test, tracking_info->win, tracking_info->bar, tracking_info->thumb_pos, tracking_info->thumb_val, tracking_info->vertical, tracking_info->hit_test, draw_arrows, draw_interior, wine_dbgstr_rect(&rect), arrow_size, thumb_pos, thumb_size, vertical, GetCapture()); user_api->pScrollBarDraw( hwnd, hdc, bar, hit_test, tracking_info, draw_arrows, draw_interior, &rect, arrow_size, thumb_pos, thumb_size, vertical ); if (bar == SB_HORZ || bar == SB_VERT) { GetClipBox( hdc, &clip_box ); if (IntersectRect(&intersect, &rect, &clip_box)) SCROLL_SetStandardScrollPainted( hwnd, bar, TRUE ); } } void SCROLL_DrawNCScrollBar( HWND hwnd, HDC hdc, BOOL draw_horizontal, BOOL draw_vertical ) { if (draw_horizontal) SCROLL_DrawScrollBar( hwnd, hdc, SB_HORZ, g_tracking_info.hit_test, &g_tracking_info, TRUE, TRUE ); if (draw_vertical) SCROLL_DrawScrollBar( hwnd, hdc, SB_VERT, g_tracking_info.hit_test, &g_tracking_info, TRUE, TRUE ); } /*********************************************************************** * SCROLL_RefreshScrollBar * * Repaint the scroll bar interior after a SetScrollRange() or * SetScrollPos() call. */ static void SCROLL_RefreshScrollBar( HWND hwnd, INT nBar, BOOL arrows, BOOL interior ) { HDC hdc = NtUserGetDCEx( hwnd, 0, DCX_CACHE | ((nBar == SB_CTL) ? 0 : DCX_WINDOW) ); if (!hdc) return; SCROLL_DrawScrollBar( hwnd, hdc, nBar, g_tracking_info.hit_test, &g_tracking_info, arrows, interior ); NtUserReleaseDC( hwnd, hdc ); } /*********************************************************************** * SCROLL_HandleKbdEvent * * Handle a keyboard event (only for SB_CTL scrollbars with focus). * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * wParam [I] Variable input including enable state * lParam [I] Variable input including input point */ static void SCROLL_HandleKbdEvent(HWND hwnd, WPARAM wParam, LPARAM lParam) { TRACE("hwnd=%p wParam=%ld lParam=%ld\n", hwnd, wParam, lParam); /* hide caret on first KEYDOWN to prevent flicker */ if ((lParam & PFD_DOUBLEBUFFER_DONTCARE) == 0) HideCaret(hwnd); switch(wParam) { case VK_PRIOR: wParam = SB_PAGEUP; break; case VK_NEXT: wParam = SB_PAGEDOWN; break; case VK_HOME: wParam = SB_TOP; break; case VK_END: wParam = SB_BOTTOM; break; case VK_UP: wParam = SB_LINEUP; break; case VK_DOWN: wParam = SB_LINEDOWN; break; case VK_LEFT: wParam = SB_LINEUP; break; case VK_RIGHT: wParam = SB_LINEDOWN; break; default: return; } SendMessageW(GetParent(hwnd), ((GetWindowLongW( hwnd, GWL_STYLE ) & SBS_VERT) ? WM_VSCROLL : WM_HSCROLL), wParam, (LPARAM)hwnd); } /*********************************************************************** * SCROLL_HandleScrollEvent * * Handle a mouse or timer event for the scrollbar. * 'pt' is the location of the mouse event in client (for SB_CTL) or * windows coordinates. */ void SCROLL_HandleScrollEvent( HWND hwnd, INT nBar, UINT msg, POINT pt ) { /* Previous mouse position for timer events */ static POINT prevPt; /* Thumb position when tracking started. */ static UINT trackThumbPos; /* Position in the scroll-bar of the last button-down event. */ static INT lastClickPos; /* Position in the scroll-bar of the last mouse event. */ static INT lastMousePos; enum SCROLL_HITTEST hittest; HWND hwndOwner, hwndCtl; TRACKMOUSEEVENT tme; BOOL vertical; INT arrowSize, thumbSize, thumbPos; RECT rect; HDC hdc; SCROLLBAR_INFO *infoPtr = SCROLL_GetInternalInfo( hwnd, nBar, FALSE ); if (!infoPtr) return; if ((g_tracking_info.hit_test == SCROLL_NOWHERE) && (msg != WM_LBUTTONDOWN && msg != WM_MOUSEMOVE && msg != WM_MOUSELEAVE && msg != WM_NCMOUSEMOVE && msg != WM_NCMOUSELEAVE)) return; if (nBar == SB_CTL && (GetWindowLongW( hwnd, GWL_STYLE ) & (SBS_SIZEGRIP | SBS_SIZEBOX))) { switch(msg) { case WM_LBUTTONDOWN: /* Initialise mouse tracking */ HideCaret(hwnd); /* hide caret while holding down LBUTTON */ NtUserSetCapture( hwnd ); prevPt = pt; g_tracking_info.hit_test = hittest = SCROLL_THUMB; break; case WM_MOUSEMOVE: GetClientRect(GetParent(GetParent(hwnd)),&rect); prevPt = pt; break; case WM_LBUTTONUP: ReleaseCapture(); g_tracking_info.hit_test = hittest = SCROLL_NOWHERE; if (hwnd==GetFocus()) ShowCaret(hwnd); break; case WM_SYSTIMER: pt = prevPt; break; } return; } hdc = NtUserGetDCEx( hwnd, 0, DCX_CACHE | ((nBar == SB_CTL) ? 0 : DCX_WINDOW)); vertical = SCROLL_GetScrollBarRect( hwnd, nBar, &rect, &arrowSize, &thumbSize, &thumbPos ); hwndOwner = (nBar == SB_CTL) ? GetParent(hwnd) : hwnd; hwndCtl = (nBar == SB_CTL) ? hwnd : 0; switch(msg) { case WM_LBUTTONDOWN: /* Initialise mouse tracking */ HideCaret(hwnd); /* hide caret while holding down LBUTTON */ g_tracking_info.vertical = vertical; g_tracking_info.hit_test = hittest = SCROLL_HitTest( hwnd, nBar, pt, FALSE ); lastClickPos = vertical ? (pt.y - rect.top) : (pt.x - rect.left); lastMousePos = lastClickPos; trackThumbPos = thumbPos; prevPt = pt; if (nBar == SB_CTL && (GetWindowLongW(hwnd, GWL_STYLE) & WS_TABSTOP)) NtUserSetFocus( hwnd ); NtUserSetCapture( hwnd ); break; case WM_MOUSEMOVE: hittest = SCROLL_HitTest( hwnd, nBar, pt, vertical == g_tracking_info.vertical && GetCapture() == hwnd ); prevPt = pt; if (nBar != SB_CTL) break; tme.cbSize = sizeof(tme); tme.dwFlags = TME_QUERY; TrackMouseEvent( &tme ); if (!(tme.dwFlags & TME_LEAVE) || tme.hwndTrack != hwnd) { tme.dwFlags = TME_LEAVE; tme.hwndTrack = hwnd; TrackMouseEvent( &tme ); } break; case WM_NCMOUSEMOVE: hittest = SCROLL_HitTest( hwnd, nBar, pt, vertical == g_tracking_info.vertical && GetCapture() == hwnd ); prevPt = pt; if (nBar == SB_CTL) break; tme.cbSize = sizeof(tme); tme.dwFlags = TME_QUERY; TrackMouseEvent( &tme ); if (((tme.dwFlags & (TME_NONCLIENT | TME_LEAVE)) != (TME_NONCLIENT | TME_LEAVE)) || tme.hwndTrack != hwnd) { tme.dwFlags = TME_NONCLIENT | TME_LEAVE; tme.hwndTrack = hwnd; TrackMouseEvent( &tme ); } break; case WM_NCMOUSELEAVE: if (nBar == SB_CTL) return; hittest = SCROLL_NOWHERE; break; case WM_MOUSELEAVE: if (nBar != SB_CTL) return; hittest = SCROLL_NOWHERE; break; case WM_LBUTTONUP: hittest = SCROLL_NOWHERE; ReleaseCapture(); /* if scrollbar has focus, show back caret */ if (hwnd==GetFocus()) ShowCaret(hwnd); break; case WM_SYSTIMER: pt = prevPt; hittest = SCROLL_HitTest( hwnd, nBar, pt, FALSE ); break; default: return; /* Should never happen */ } TRACE("Event: hwnd=%p bar=%d msg=%s pt=%d,%d hit=%d\n", hwnd, nBar, SPY_GetMsgName(msg,hwnd), pt.x, pt.y, hittest ); switch (g_tracking_info.hit_test) { case SCROLL_NOWHERE: /* No tracking in progress */ /* For standard scroll bars, hovered state gets painted only when the scroll bar was * previously painted by DefWinProc(). If an application handles WM_NCPAINT by itself, then * the scrollbar shouldn't be repainted here to avoid overwriting the application painted * content */ if (msg == WM_MOUSEMOVE || msg == WM_MOUSELEAVE || ((msg == WM_NCMOUSEMOVE || msg == WM_NCMOUSELEAVE) && SCROLL_IsStandardScrollPainted( hwnd, nBar))) SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, TRUE, TRUE ); break; case SCROLL_TOP_ARROW: SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, TRUE, FALSE ); if (hittest == g_tracking_info.hit_test) { if ((msg == WM_LBUTTONDOWN) || (msg == WM_SYSTIMER)) { SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, SB_LINEUP, (LPARAM)hwndCtl ); } NtUserSetSystemTimer( hwnd, SCROLL_TIMER, (msg == WM_LBUTTONDOWN) ? SCROLL_FIRST_DELAY : SCROLL_REPEAT_DELAY, NULL ); } else KillSystemTimer( hwnd, SCROLL_TIMER ); break; case SCROLL_TOP_RECT: SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, FALSE, TRUE ); if (hittest == g_tracking_info.hit_test) { if ((msg == WM_LBUTTONDOWN) || (msg == WM_SYSTIMER)) { SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, SB_PAGEUP, (LPARAM)hwndCtl ); } NtUserSetSystemTimer( hwnd, SCROLL_TIMER, (msg == WM_LBUTTONDOWN) ? SCROLL_FIRST_DELAY : SCROLL_REPEAT_DELAY, NULL ); } else KillSystemTimer( hwnd, SCROLL_TIMER ); break; case SCROLL_THUMB: if (msg == WM_LBUTTONDOWN) { g_tracking_info.win = hwnd; g_tracking_info.bar = nBar; g_tracking_info.thumb_pos = trackThumbPos + lastMousePos - lastClickPos; g_tracking_info.thumb_val = SCROLL_GetThumbVal( hwnd, infoPtr, &rect, vertical, g_tracking_info.thumb_pos ); if (!SCROLL_MovingThumb) { SCROLL_MovingThumb = TRUE; SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, FALSE, TRUE ); } } else if (msg == WM_LBUTTONUP) { SCROLL_DrawScrollBar( hwnd, hdc, nBar, SCROLL_NOWHERE, &g_tracking_info, FALSE, TRUE ); } else if (msg == WM_MOUSEMOVE) { INT pos; if (!SCROLL_PtInRectEx( &rect, pt, vertical )) pos = lastClickPos; else { pt = SCROLL_ClipPos( &rect, pt ); pos = vertical ? (pt.y - rect.top) : (pt.x - rect.left); } if ( (pos != lastMousePos) || (!SCROLL_MovingThumb) ) { lastMousePos = pos; g_tracking_info.thumb_pos = trackThumbPos + pos - lastClickPos; g_tracking_info.thumb_val = SCROLL_GetThumbVal( hwnd, infoPtr, &rect, vertical, g_tracking_info.thumb_pos ); SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, MAKEWPARAM( SB_THUMBTRACK, g_tracking_info.thumb_val ), (LPARAM)hwndCtl ); SCROLL_MovingThumb = TRUE; SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, FALSE, TRUE ); } } break; case SCROLL_BOTTOM_RECT: SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, FALSE, TRUE ); if (hittest == g_tracking_info.hit_test) { if ((msg == WM_LBUTTONDOWN) || (msg == WM_SYSTIMER)) { SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, SB_PAGEDOWN, (LPARAM)hwndCtl ); } NtUserSetSystemTimer( hwnd, SCROLL_TIMER, (msg == WM_LBUTTONDOWN) ? SCROLL_FIRST_DELAY : SCROLL_REPEAT_DELAY, NULL ); } else KillSystemTimer( hwnd, SCROLL_TIMER ); break; case SCROLL_BOTTOM_ARROW: SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, TRUE, FALSE ); if (hittest == g_tracking_info.hit_test) { if ((msg == WM_LBUTTONDOWN) || (msg == WM_SYSTIMER)) { SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, SB_LINEDOWN, (LPARAM)hwndCtl ); } NtUserSetSystemTimer( hwnd, SCROLL_TIMER, (msg == WM_LBUTTONDOWN) ? SCROLL_FIRST_DELAY : SCROLL_REPEAT_DELAY, NULL ); } else KillSystemTimer( hwnd, SCROLL_TIMER ); break; } if (msg == WM_LBUTTONDOWN) { if (hittest == SCROLL_THUMB) { UINT val = SCROLL_GetThumbVal( hwnd, infoPtr, &rect, vertical, trackThumbPos + lastMousePos - lastClickPos ); SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, MAKEWPARAM( SB_THUMBTRACK, val ), (LPARAM)hwndCtl ); } } if (msg == WM_LBUTTONUP) { hittest = g_tracking_info.hit_test; g_tracking_info.hit_test = SCROLL_NOWHERE; /* Terminate tracking */ if (hittest == SCROLL_THUMB) { UINT val = SCROLL_GetThumbVal( hwnd, infoPtr, &rect, vertical, trackThumbPos + lastMousePos - lastClickPos ); SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, MAKEWPARAM( SB_THUMBPOSITION, val ), (LPARAM)hwndCtl ); } /* SB_ENDSCROLL doesn't report thumb position */ SendMessageW( hwndOwner, vertical ? WM_VSCROLL : WM_HSCROLL, SB_ENDSCROLL, (LPARAM)hwndCtl ); /* Terminate tracking */ g_tracking_info.win = 0; SCROLL_MovingThumb = FALSE; hittest = SCROLL_NOWHERE; SCROLL_DrawScrollBar( hwnd, hdc, nBar, hittest, &g_tracking_info, TRUE, TRUE ); } NtUserReleaseDC( hwnd, hdc ); } /*********************************************************************** * SCROLL_TrackScrollBar * * Track a mouse button press on a scroll-bar. * pt is in screen-coordinates for non-client scroll bars. */ void SCROLL_TrackScrollBar( HWND hwnd, INT scrollbar, POINT pt ) { MSG msg; RECT rect; if (scrollbar != SB_CTL) { WIN_GetRectangles( hwnd, COORDS_CLIENT, &rect, NULL ); ScreenToClient( hwnd, &pt ); pt.x -= rect.left; pt.y -= rect.top; } else rect.left = rect.top = 0; SCROLL_HandleScrollEvent( hwnd, scrollbar, WM_LBUTTONDOWN, pt ); do { if (!GetMessageW( &msg, 0, 0, 0 )) break; if (CallMsgFilterW( &msg, MSGF_SCROLLBAR )) continue; if (msg.message == WM_LBUTTONUP || msg.message == WM_MOUSEMOVE || msg.message == WM_MOUSELEAVE || msg.message == WM_NCMOUSEMOVE || msg.message == WM_NCMOUSELEAVE || (msg.message == WM_SYSTIMER && msg.wParam == SCROLL_TIMER)) { pt.x = (short)LOWORD(msg.lParam) - rect.left; pt.y = (short)HIWORD(msg.lParam) - rect.top; SCROLL_HandleScrollEvent( hwnd, scrollbar, msg.message, pt ); } else { TranslateMessage( &msg ); DispatchMessageW( &msg ); } if (!IsWindow( hwnd )) { ReleaseCapture(); break; } } while (msg.message != WM_LBUTTONUP && GetCapture() == hwnd); } /*********************************************************************** * SCROLL_CreateScrollBar * * Create a scroll bar * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * lpCreate [I] The style and place of the scroll bar */ static void SCROLL_CreateScrollBar(HWND hwnd, LPCREATESTRUCTW lpCreate) { LPSCROLLBAR_INFO info = NULL; WND *win; TRACE("hwnd=%p lpCreate=%p\n", hwnd, lpCreate); win = WIN_GetPtr(hwnd); if (win->cbWndExtra >= sizeof(SCROLLBAR_WNDDATA)) { SCROLLBAR_WNDDATA *data = (SCROLLBAR_WNDDATA*)win->wExtra; data->magic = SCROLLBAR_MAGIC; info = &data->info; } else WARN("Not enough extra data\n"); WIN_ReleasePtr(win); if (!info) return; if (lpCreate->style & WS_DISABLED) { info->flags = ESB_DISABLE_BOTH; TRACE("Created WS_DISABLED scrollbar\n"); } if (lpCreate->style & (SBS_SIZEGRIP | SBS_SIZEBOX)) { if (lpCreate->style & SBS_SIZEBOXTOPLEFTALIGN) NtUserMoveWindow( hwnd, lpCreate->x, lpCreate->y, GetSystemMetrics(SM_CXVSCROLL)+1, GetSystemMetrics(SM_CYHSCROLL)+1, FALSE ); else if(lpCreate->style & SBS_SIZEBOXBOTTOMRIGHTALIGN) NtUserMoveWindow( hwnd, lpCreate->x+lpCreate->cx-GetSystemMetrics(SM_CXVSCROLL)-1, lpCreate->y+lpCreate->cy-GetSystemMetrics(SM_CYHSCROLL)-1, GetSystemMetrics(SM_CXVSCROLL)+1, GetSystemMetrics(SM_CYHSCROLL)+1, FALSE ); } else if (lpCreate->style & SBS_VERT) { if (lpCreate->style & SBS_LEFTALIGN) NtUserMoveWindow( hwnd, lpCreate->x, lpCreate->y, GetSystemMetrics(SM_CXVSCROLL)+1, lpCreate->cy, FALSE ); else if (lpCreate->style & SBS_RIGHTALIGN) NtUserMoveWindow( hwnd, lpCreate->x+lpCreate->cx-GetSystemMetrics(SM_CXVSCROLL)-1, lpCreate->y, GetSystemMetrics(SM_CXVSCROLL)+1, lpCreate->cy, FALSE ); } else /* SBS_HORZ */ { if (lpCreate->style & SBS_TOPALIGN) NtUserMoveWindow( hwnd, lpCreate->x, lpCreate->y, lpCreate->cx, GetSystemMetrics(SM_CYHSCROLL)+1, FALSE ); else if (lpCreate->style & SBS_BOTTOMALIGN) NtUserMoveWindow( hwnd, lpCreate->x, lpCreate->y+lpCreate->cy-GetSystemMetrics(SM_CYHSCROLL)-1, lpCreate->cx, GetSystemMetrics(SM_CYHSCROLL)+1, FALSE ); } } /************************************************************************* * SCROLL_GetScrollInfo * * Internal helper for the API function * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * info [IO] fMask specifies which values to retrieve * * RETURNS * FALSE if requested field not filled (f.i. scroll bar does not exist) */ static BOOL SCROLL_GetScrollInfo(HWND hwnd, INT nBar, LPSCROLLINFO info) { LPSCROLLBAR_INFO infoPtr; /* handle invalid data structure */ if (!SCROLL_ScrollInfoValid(info) || !(infoPtr = SCROLL_GetInternalInfo(hwnd, nBar, FALSE))) return FALSE; /* fill in the desired scroll info structure */ if (info->fMask & SIF_PAGE) info->nPage = infoPtr->page; if (info->fMask & SIF_POS) info->nPos = infoPtr->curVal; if ((info->fMask & SIF_TRACKPOS) && (info->cbSize == sizeof(*info))) info->nTrackPos = (g_tracking_info.win == WIN_GetFullHandle(hwnd)) ? g_tracking_info.thumb_val : infoPtr->curVal; if (info->fMask & SIF_RANGE) { info->nMin = infoPtr->minVal; info->nMax = infoPtr->maxVal; } TRACE("cbSize %02x fMask %04x nMin %d nMax %d nPage %u nPos %d nTrackPos %d\n", info->cbSize, info->fMask, info->nMin, info->nMax, info->nPage, info->nPos, info->nTrackPos); return (info->fMask & SIF_ALL) != 0; } /************************************************************************* * SCROLL_GetScrollBarInfo * * Internal helper for the API function * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * idObject [I] One of OBJID_CLIENT, OBJID_HSCROLL, or OBJID_VSCROLL * info [IO] cbSize specifies the size of the structure * * RETURNS * FALSE if failed */ static BOOL SCROLL_GetScrollBarInfo(HWND hwnd, LONG idObject, LPSCROLLBARINFO info) { LPSCROLLBAR_INFO infoPtr; INT nBar; INT nDummy; DWORD style = GetWindowLongW(hwnd, GWL_STYLE); BOOL pressed; RECT rect; switch (idObject) { case OBJID_CLIENT: nBar = SB_CTL; break; case OBJID_HSCROLL: nBar = SB_HORZ; break; case OBJID_VSCROLL: nBar = SB_VERT; break; default: return FALSE; } /* handle invalid data structure */ if (info->cbSize != sizeof(*info)) return FALSE; SCROLL_GetScrollBarRect(hwnd, nBar, &info->rcScrollBar, &nDummy, &info->dxyLineButton, &info->xyThumbTop); /* rcScrollBar needs to be in screen coordinates */ GetWindowRect(hwnd, &rect); OffsetRect(&info->rcScrollBar, rect.left, rect.top); info->xyThumbBottom = info->xyThumbTop + info->dxyLineButton; infoPtr = SCROLL_GetInternalInfo(hwnd, nBar, TRUE); if (!infoPtr) return FALSE; /* Scroll bar state */ info->rgstate[0] = 0; if ((nBar == SB_HORZ && !(style & WS_HSCROLL)) || (nBar == SB_VERT && !(style & WS_VSCROLL))) info->rgstate[0] |= STATE_SYSTEM_INVISIBLE; if (infoPtr->minVal >= infoPtr->maxVal - max(infoPtr->page - 1, 0)) { if (!(info->rgstate[0] & STATE_SYSTEM_INVISIBLE)) info->rgstate[0] |= STATE_SYSTEM_UNAVAILABLE; else info->rgstate[0] |= STATE_SYSTEM_OFFSCREEN; } if (nBar == SB_CTL && !IsWindowEnabled(hwnd)) info->rgstate[0] |= STATE_SYSTEM_UNAVAILABLE; pressed = ((nBar == SB_VERT) == g_tracking_info.vertical && GetCapture() == hwnd); /* Top/left arrow button state. MSDN says top/right, but I don't believe it */ info->rgstate[1] = 0; if (pressed && g_tracking_info.hit_test == SCROLL_TOP_ARROW) info->rgstate[1] |= STATE_SYSTEM_PRESSED; if (infoPtr->flags & ESB_DISABLE_LTUP) info->rgstate[1] |= STATE_SYSTEM_UNAVAILABLE; /* Page up/left region state. MSDN says up/right, but I don't believe it */ info->rgstate[2] = 0; if (infoPtr->curVal == infoPtr->minVal) info->rgstate[2] |= STATE_SYSTEM_INVISIBLE; if (pressed && g_tracking_info.hit_test == SCROLL_TOP_RECT) info->rgstate[2] |= STATE_SYSTEM_PRESSED; /* Thumb state */ info->rgstate[3] = 0; if (pressed && g_tracking_info.hit_test == SCROLL_THUMB) info->rgstate[3] |= STATE_SYSTEM_PRESSED; /* Page down/right region state. MSDN says down/left, but I don't believe it */ info->rgstate[4] = 0; if (infoPtr->curVal >= infoPtr->maxVal - 1) info->rgstate[4] |= STATE_SYSTEM_INVISIBLE; if (pressed && g_tracking_info.hit_test == SCROLL_BOTTOM_RECT) info->rgstate[4] |= STATE_SYSTEM_PRESSED; /* Bottom/right arrow button state. MSDN says bottom/left, but I don't believe it */ info->rgstate[5] = 0; if (pressed && g_tracking_info.hit_test == SCROLL_BOTTOM_ARROW) info->rgstate[5] |= STATE_SYSTEM_PRESSED; if (infoPtr->flags & ESB_DISABLE_RTDN) info->rgstate[5] |= STATE_SYSTEM_UNAVAILABLE; return TRUE; } /************************************************************************* * SCROLL_GetScrollPos * * Internal helper for the API function * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL */ static INT SCROLL_GetScrollPos(HWND hwnd, INT nBar) { LPSCROLLBAR_INFO infoPtr = SCROLL_GetInternalInfo(hwnd, nBar, FALSE); return infoPtr ? infoPtr->curVal: 0; } /************************************************************************* * SCROLL_GetScrollRange * * Internal helper for the API function * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * lpMin [O] Where to store minimum value * lpMax [O] Where to store maximum value * * RETURNS * Success: TRUE * Failure: FALSE */ static BOOL SCROLL_GetScrollRange(HWND hwnd, INT nBar, LPINT lpMin, LPINT lpMax) { LPSCROLLBAR_INFO infoPtr = SCROLL_GetInternalInfo(hwnd, nBar, FALSE); if (lpMin) *lpMin = infoPtr ? infoPtr->minVal : 0; if (lpMax) *lpMax = infoPtr ? infoPtr->maxVal : 0; return TRUE; } /************************************************************************* * SCROLL_SetScrollRange * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * lpMin [I] Minimum value * lpMax [I] Maximum value * */ static BOOL SCROLL_SetScrollRange(HWND hwnd, INT nBar, INT minVal, INT maxVal) { LPSCROLLBAR_INFO infoPtr = SCROLL_GetInternalInfo(hwnd, nBar, FALSE); TRACE("hwnd=%p nBar=%d min=%d max=%d\n", hwnd, nBar, minVal, maxVal); if (infoPtr) { infoPtr->minVal = minVal; infoPtr->maxVal = maxVal; } return TRUE; } LRESULT WINAPI USER_ScrollBarProc( HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam, BOOL unicode ) { if (!IsWindow( hwnd )) return 0; switch(message) { case WM_CREATE: SCROLL_CreateScrollBar(hwnd, (LPCREATESTRUCTW)lParam); break; case WM_ENABLE: { SCROLLBAR_INFO *infoPtr; if ((infoPtr = SCROLL_GetInternalInfo( hwnd, SB_CTL, FALSE ))) { infoPtr->flags = wParam ? ESB_ENABLE_BOTH : ESB_DISABLE_BOTH; SCROLL_RefreshScrollBar(hwnd, SB_CTL, TRUE, TRUE); } } return 0; case WM_LBUTTONDBLCLK: case WM_LBUTTONDOWN: if (GetWindowLongW( hwnd, GWL_STYLE ) & SBS_SIZEGRIP) { SendMessageW( GetParent(hwnd), WM_SYSCOMMAND, SC_SIZE + ((GetWindowLongW( hwnd, GWL_EXSTYLE ) & WS_EX_LAYOUTRTL) ? WMSZ_BOTTOMLEFT : WMSZ_BOTTOMRIGHT), lParam ); } else { POINT pt; pt.x = (short)LOWORD(lParam); pt.y = (short)HIWORD(lParam); SCROLL_TrackScrollBar( hwnd, SB_CTL, pt ); } break; case WM_LBUTTONUP: case WM_NCMOUSEMOVE: case WM_NCMOUSELEAVE: case WM_MOUSEMOVE: case WM_MOUSELEAVE: case WM_SYSTIMER: { POINT pt; pt.x = (short)LOWORD(lParam); pt.y = (short)HIWORD(lParam); SCROLL_HandleScrollEvent( hwnd, SB_CTL, message, pt ); } break; case WM_KEYDOWN: SCROLL_HandleKbdEvent(hwnd, wParam, lParam); break; case WM_KEYUP: ShowCaret(hwnd); break; case WM_SETFOCUS: { /* Create a caret when a ScrollBar get focus */ RECT rect; int arrowSize, thumbSize, thumbPos, vertical; vertical = SCROLL_GetScrollBarRect( hwnd, SB_CTL, &rect, &arrowSize, &thumbSize, &thumbPos ); if (!vertical) { CreateCaret(hwnd, (HBITMAP)1, thumbSize-2, rect.bottom-rect.top-2); SetCaretPos(thumbPos+1, rect.top+1); } else { CreateCaret(hwnd, (HBITMAP)1, rect.right-rect.left-2,thumbSize-2); SetCaretPos(rect.top+1, thumbPos+1); } ShowCaret(hwnd); } break; case WM_KILLFOCUS: { RECT rect; int arrowSize, thumbSize, thumbPos, vertical; vertical = SCROLL_GetScrollBarRect( hwnd, SB_CTL, &rect,&arrowSize, &thumbSize, &thumbPos ); if (!vertical){ rect.left=thumbPos+1; rect.right=rect.left+thumbSize; } else { rect.top=thumbPos+1; rect.bottom=rect.top+thumbSize; } HideCaret(hwnd); InvalidateRect(hwnd,&rect,0); DestroyCaret(); } break; case WM_ERASEBKGND: return 1; case WM_GETDLGCODE: return DLGC_WANTARROWS; /* Windows returns this value */ case WM_PAINT: { PAINTSTRUCT ps; HDC hdc = wParam ? (HDC)wParam : NtUserBeginPaint( hwnd, &ps ); SCROLL_DrawScrollBar( hwnd, hdc, SB_CTL, g_tracking_info.hit_test, &g_tracking_info, TRUE, TRUE ); if (!wParam) NtUserEndPaint( hwnd, &ps ); } break; case WM_SETCURSOR: if (GetWindowLongW( hwnd, GWL_STYLE ) & SBS_SIZEGRIP) { ULONG_PTR cursor = (GetWindowLongW( hwnd, GWL_EXSTYLE ) & WS_EX_LAYOUTRTL) ? IDC_SIZENESW : IDC_SIZENWSE; return (LRESULT)NtUserSetCursor( LoadCursorA( 0, (LPSTR)cursor )); } return DefWindowProcW( hwnd, message, wParam, lParam ); case SBM_SETPOS: return SetScrollPos( hwnd, SB_CTL, wParam, (BOOL)lParam ); case SBM_GETPOS: return SCROLL_GetScrollPos(hwnd, SB_CTL); case SBM_SETRANGEREDRAW: case SBM_SETRANGE: { INT oldPos = SCROLL_GetScrollPos( hwnd, SB_CTL ); SCROLL_SetScrollRange( hwnd, SB_CTL, wParam, lParam ); if (message == SBM_SETRANGEREDRAW) SCROLL_RefreshScrollBar( hwnd, SB_CTL, TRUE, TRUE ); if (oldPos != SCROLL_GetScrollPos( hwnd, SB_CTL )) return oldPos; } return 0; case SBM_GETRANGE: return SCROLL_GetScrollRange(hwnd, SB_CTL, (LPINT)wParam, (LPINT)lParam); case SBM_ENABLE_ARROWS: return EnableScrollBar( hwnd, SB_CTL, wParam ); case SBM_SETSCROLLINFO: return SCROLL_SetScrollInfo( hwnd, SB_CTL, (SCROLLINFO *)lParam, wParam ); case SBM_GETSCROLLINFO: return SCROLL_GetScrollInfo(hwnd, SB_CTL, (SCROLLINFO *)lParam); case SBM_GETSCROLLBARINFO: return SCROLL_GetScrollBarInfo(hwnd, OBJID_CLIENT, (SCROLLBARINFO *)lParam); case 0x00e5: case 0x00e7: case 0x00e8: case 0x00ec: case 0x00ed: case 0x00ee: case 0x00ef: ERR("unknown Win32 msg %04x wp=%08lx lp=%08lx\n", message, wParam, lParam ); break; default: if (message >= WM_USER) WARN("unknown msg %04x wp=%04lx lp=%08lx\n", message, wParam, lParam ); if (unicode) return DefWindowProcW( hwnd, message, wParam, lParam ); else return DefWindowProcA( hwnd, message, wParam, lParam ); } return 0; } /*********************************************************************** * ScrollBarWndProc_common */ LRESULT ScrollBarWndProc_common( HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam, BOOL unicode ) { return user_api->pScrollBarWndProc( hwnd, msg, wParam, lParam, unicode ); } /************************************************************************* * SetScrollInfo (USER32.@) * * SetScrollInfo can be used to set the position, upper bound, * lower bound, and page size of a scrollbar control. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * info [I] Specifies what to change and new values * bRedraw [I] Should scrollbar be redrawn afterwards? * * RETURNS * Scrollbar position * * NOTE * For 100 lines of text to be displayed in a window of 25 lines, * one would for instance use info->nMin=0, info->nMax=75 * (corresponding to the 76 different positions of the window on * the text), and info->nPage=25. */ INT WINAPI DECLSPEC_HOTPATCH SetScrollInfo(HWND hwnd, INT nBar, const SCROLLINFO *info, BOOL bRedraw) { TRACE("hwnd=%p nBar=%d info=%p, bRedraw=%d\n", hwnd, nBar, info, bRedraw); /* Refer SB_CTL requests to the window */ if (nBar == SB_CTL) return SendMessageW(hwnd, SBM_SETSCROLLINFO, bRedraw, (LPARAM)info); else return SCROLL_SetScrollInfo( hwnd, nBar, info, bRedraw ); } static INT SCROLL_SetScrollInfo( HWND hwnd, INT nBar, LPCSCROLLINFO info, BOOL bRedraw ) { /* Update the scrollbar state and set action flags according to * what has to be done graphics wise. */ SCROLLBAR_INFO *infoPtr; UINT new_flags; INT action = 0; /* handle invalid data structure */ if (!SCROLL_ScrollInfoValid(info) || !(infoPtr = SCROLL_GetInternalInfo(hwnd, nBar, TRUE))) return 0; if (TRACE_ON(scroll)) { TRACE("hwnd=%p bar=%d", hwnd, nBar); if (info->fMask & SIF_PAGE) TRACE( " page=%d", info->nPage ); if (info->fMask & SIF_POS) TRACE( " pos=%d", info->nPos ); if (info->fMask & SIF_RANGE) TRACE( " min=%d max=%d", info->nMin, info->nMax ); TRACE("\n"); } /* Set the page size */ if (info->fMask & SIF_PAGE) { if( infoPtr->page != info->nPage ) { infoPtr->page = info->nPage; action |= SA_SSI_REFRESH; } } /* Set the scroll pos */ if (info->fMask & SIF_POS) { if( infoPtr->curVal != info->nPos ) { infoPtr->curVal = info->nPos; action |= SA_SSI_REFRESH; } } /* Set the scroll range */ if (info->fMask & SIF_RANGE) { /* Invalid range -> range is set to (0,0) */ if ((info->nMin > info->nMax) || ((UINT)(info->nMax - info->nMin) >= 0x80000000)) { action |= SA_SSI_REFRESH; infoPtr->minVal = 0; infoPtr->maxVal = 0; } else { if( infoPtr->minVal != info->nMin || infoPtr->maxVal != info->nMax ) { action |= SA_SSI_REFRESH; infoPtr->minVal = info->nMin; infoPtr->maxVal = info->nMax; } } } /* Make sure the page size is valid */ if (infoPtr->page < 0) infoPtr->page = 0; else if (infoPtr->page > infoPtr->maxVal - infoPtr->minVal + 1 ) infoPtr->page = infoPtr->maxVal - infoPtr->minVal + 1; /* Make sure the pos is inside the range */ if (infoPtr->curVal < infoPtr->minVal) infoPtr->curVal = infoPtr->minVal; else if (infoPtr->curVal > infoPtr->maxVal - max( infoPtr->page-1, 0 )) infoPtr->curVal = infoPtr->maxVal - max( infoPtr->page-1, 0 ); TRACE(" new values: page=%d pos=%d min=%d max=%d\n", infoPtr->page, infoPtr->curVal, infoPtr->minVal, infoPtr->maxVal ); /* don't change the scrollbar state if SetScrollInfo * is just called with SIF_DISABLENOSCROLL */ if(!(info->fMask & SIF_ALL)) goto done; /* Check if the scrollbar should be hidden or disabled */ if (info->fMask & (SIF_RANGE | SIF_PAGE | SIF_DISABLENOSCROLL)) { new_flags = infoPtr->flags; if (infoPtr->minVal >= infoPtr->maxVal - max( infoPtr->page-1, 0 )) { /* Hide or disable scroll-bar */ if (info->fMask & SIF_DISABLENOSCROLL) { new_flags = ESB_DISABLE_BOTH; action |= SA_SSI_REFRESH; } else if ((nBar != SB_CTL) && (action & SA_SSI_REFRESH)) { action = SA_SSI_HIDE; } } else /* Show and enable scroll-bar only if no page only changed. */ if (info->fMask != SIF_PAGE) { new_flags = ESB_ENABLE_BOTH; if ((nBar != SB_CTL) && ( (action & SA_SSI_REFRESH) )) action |= SA_SSI_SHOW; } if (nBar == SB_CTL && bRedraw && IsWindowVisible(hwnd) && (new_flags == ESB_ENABLE_BOTH || new_flags == ESB_DISABLE_BOTH)) { EnableWindow(hwnd, new_flags == ESB_ENABLE_BOTH); } if (infoPtr->flags != new_flags) /* check arrow flags */ { infoPtr->flags = new_flags; action |= SA_SSI_REPAINT_ARROWS; } } done: if( action & SA_SSI_HIDE ) SCROLL_ShowScrollBar( hwnd, nBar, FALSE, FALSE ); else { if( action & SA_SSI_SHOW ) if( SCROLL_ShowScrollBar( hwnd, nBar, TRUE, TRUE ) ) return infoPtr->curVal; /* SetWindowPos() already did the painting */ if( bRedraw ) SCROLL_RefreshScrollBar( hwnd, nBar, TRUE, TRUE ); else if( action & SA_SSI_REPAINT_ARROWS ) SCROLL_RefreshScrollBar( hwnd, nBar, TRUE, FALSE ); } /* Return current position */ return infoPtr->curVal; } /************************************************************************* * GetScrollInfo (USER32.@) * * GetScrollInfo can be used to retrieve the position, upper bound, * lower bound, and page size of a scrollbar control. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * info [IO] fMask specifies which values to retrieve * * RETURNS * TRUE if SCROLLINFO is filled * ( if nBar is SB_CTL, GetScrollInfo returns TRUE even if nothing * is filled) */ BOOL WINAPI DECLSPEC_HOTPATCH GetScrollInfo(HWND hwnd, INT nBar, LPSCROLLINFO info) { TRACE("hwnd=%p nBar=%d info=%p\n", hwnd, nBar, info); /* Refer SB_CTL requests to the window */ if (nBar == SB_CTL) { SendMessageW(hwnd, SBM_GETSCROLLINFO, 0, (LPARAM)info); return TRUE; } return SCROLL_GetScrollInfo(hwnd, nBar, info); } /************************************************************************* * GetScrollBarInfo (USER32.@) * * GetScrollBarInfo can be used to retrieve information about a scrollbar * control. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * idObject [I] One of OBJID_CLIENT, OBJID_HSCROLL, or OBJID_VSCROLL * info [IO] cbSize specifies the size of SCROLLBARINFO * * RETURNS * TRUE if success */ BOOL WINAPI GetScrollBarInfo(HWND hwnd, LONG idObject, LPSCROLLBARINFO info) { TRACE("hwnd=%p idObject=%d info=%p\n", hwnd, idObject, info); /* Refer OBJID_CLIENT requests to the window */ if (idObject == OBJID_CLIENT) return SendMessageW(hwnd, SBM_GETSCROLLBARINFO, 0, (LPARAM)info); else return SCROLL_GetScrollBarInfo(hwnd, idObject, info); } /************************************************************************* * SetScrollPos (USER32.@) * * Sets the current position of the scroll thumb. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * nPos [I] New value * bRedraw [I] Should scrollbar be redrawn afterwards? * * RETURNS * Success: Scrollbar position * Failure: 0 * * REMARKS * Note the ambiguity when 0 is returned. Use GetLastError * to make sure there was an error (and to know which one). */ INT WINAPI DECLSPEC_HOTPATCH SetScrollPos( HWND hwnd, INT nBar, INT nPos, BOOL bRedraw) { SCROLLINFO info; SCROLLBAR_INFO *infoPtr; INT oldPos = 0; if ((infoPtr = SCROLL_GetInternalInfo( hwnd, nBar, FALSE ))) oldPos = infoPtr->curVal; info.cbSize = sizeof(info); info.nPos = nPos; info.fMask = SIF_POS; SetScrollInfo( hwnd, nBar, &info, bRedraw ); return oldPos; } /************************************************************************* * GetScrollPos (USER32.@) * * Gets the current position of the scroll thumb. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * * RETURNS * Success: Current position * Failure: 0 * * REMARKS * There is ambiguity when 0 is returned. Use GetLastError * to make sure there was an error (and to know which one). */ INT WINAPI DECLSPEC_HOTPATCH GetScrollPos(HWND hwnd, INT nBar) { TRACE("hwnd=%p nBar=%d\n", hwnd, nBar); /* Refer SB_CTL requests to the window */ if (nBar == SB_CTL) return SendMessageW(hwnd, SBM_GETPOS, 0, 0); else return SCROLL_GetScrollPos(hwnd, nBar); } /************************************************************************* * SetScrollRange (USER32.@) * The SetScrollRange function sets the minimum and maximum scroll box positions * If nMinPos and nMaxPos is the same value, the scroll bar will hide * * Sets the range of the scroll bar. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * minVal [I] New minimum value * maxVal [I] New Maximum value * bRedraw [I] Should scrollbar be redrawn afterwards? * * RETURNS * Success: TRUE * Failure: FALSE */ BOOL WINAPI DECLSPEC_HOTPATCH SetScrollRange(HWND hwnd, INT nBar, INT minVal, INT maxVal, BOOL bRedraw) { SCROLLINFO info; TRACE("hwnd=%p nBar=%d min=%d max=%d, bRedraw=%d\n", hwnd, nBar, minVal, maxVal, bRedraw); info.cbSize = sizeof(info); info.fMask = SIF_RANGE; info.nMin = minVal; info.nMax = maxVal; SetScrollInfo( hwnd, nBar, &info, bRedraw ); return TRUE; } /************************************************************************* * GetScrollRange (USER32.@) * * Gets the range of the scroll bar. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * lpMin [O] Where to store minimum value * lpMax [O] Where to store maximum value * * RETURNS * TRUE if values is filled */ BOOL WINAPI DECLSPEC_HOTPATCH GetScrollRange(HWND hwnd, INT nBar, LPINT lpMin, LPINT lpMax) { TRACE("hwnd=%p nBar=%d lpMin=%p lpMax=%p\n", hwnd, nBar, lpMin, lpMax); /* Refer SB_CTL requests to the window */ if (nBar == SB_CTL) SendMessageW(hwnd, SBM_GETRANGE, (WPARAM)lpMin, (LPARAM)lpMax); else SCROLL_GetScrollRange(hwnd, nBar, lpMin, lpMax); return TRUE; } /************************************************************************* * SCROLL_ShowScrollBar() * * Back-end for ShowScrollBar(). Returns FALSE if no action was taken. */ static BOOL SCROLL_ShowScrollBar( HWND hwnd, INT nBar, BOOL fShowH, BOOL fShowV ) { ULONG old_style, set_bits = 0, clear_bits = 0; TRACE("hwnd=%p bar=%d horz=%d, vert=%d\n", hwnd, nBar, fShowH, fShowV ); switch(nBar) { case SB_CTL: ShowWindow( hwnd, fShowH ? SW_SHOW : SW_HIDE ); return TRUE; case SB_BOTH: case SB_HORZ: if (fShowH) set_bits |= WS_HSCROLL; else clear_bits |= WS_HSCROLL; if( nBar == SB_HORZ ) break; /* fall through */ case SB_VERT: if (fShowV) set_bits |= WS_VSCROLL; else clear_bits |= WS_VSCROLL; break; default: return FALSE; /* Nothing to do! */ } old_style = WIN_SetStyle( hwnd, set_bits, clear_bits ); if ((old_style & clear_bits) != 0 || (old_style & set_bits) != set_bits) { /* frame has been changed, let the window redraw itself */ NtUserSetWindowPos( hwnd, 0, 0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_NOACTIVATE | SWP_NOZORDER | SWP_FRAMECHANGED ); return TRUE; } return FALSE; /* no frame changes */ } /************************************************************************* * ShowScrollBar (USER32.@) * * Shows or hides the scroll bar. * * PARAMS * hwnd [I] Handle of window with scrollbar(s) * nBar [I] One of SB_HORZ, SB_VERT, or SB_CTL * fShow [I] TRUE = show, FALSE = hide * * RETURNS * Success: TRUE * Failure: FALSE */ BOOL WINAPI DECLSPEC_HOTPATCH ShowScrollBar(HWND hwnd, INT nBar, BOOL fShow) { if ( !hwnd ) return FALSE; SCROLL_ShowScrollBar( hwnd, nBar, (nBar == SB_VERT) ? 0 : fShow, (nBar == SB_HORZ) ? 0 : fShow ); return TRUE; } /************************************************************************* * EnableScrollBar (USER32.@) * * Enables or disables the scroll bars. */ BOOL WINAPI DECLSPEC_HOTPATCH EnableScrollBar( HWND hwnd, UINT nBar, UINT flags ) { BOOL bFineWithMe; SCROLLBAR_INFO *infoPtr; flags &= ESB_DISABLE_BOTH; if (nBar == SB_BOTH) { if (!(infoPtr = SCROLL_GetInternalInfo( hwnd, SB_VERT, TRUE ))) return FALSE; if (!(bFineWithMe = (infoPtr->flags == flags)) ) { infoPtr->flags = flags; SCROLL_RefreshScrollBar( hwnd, SB_VERT, TRUE, TRUE ); } nBar = SB_HORZ; } else bFineWithMe = nBar != SB_CTL; if (!(infoPtr = SCROLL_GetInternalInfo( hwnd, nBar, TRUE ))) return FALSE; if (bFineWithMe && infoPtr->flags == flags) return FALSE; infoPtr->flags = flags; if (nBar == SB_CTL && (flags == ESB_DISABLE_BOTH || flags == ESB_ENABLE_BOTH)) EnableWindow(hwnd, flags == ESB_ENABLE_BOTH); SCROLL_RefreshScrollBar( hwnd, nBar, TRUE, TRUE ); return TRUE; }