2 * Common controls functions
4 * Copyright 1997 Dimitrie O. Paun
5 * Copyright 1998,2000 Eric Kohl
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.
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.
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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 * This code was audited for completeness against the documented features
24 * of Comctl32.dll version 6.0 on Oct. 21, 2002, by Christian Neumair.
26 * Unless otherwise noted, we believe this code to be complete, as per
27 * the specification mentioned above.
28 * If you discover missing features, or bugs, please note them below.
31 * -- implement GetMUILanguage + InitMUILanguage
32 * -- finish NOTES for MenuHelp, GetEffectiveClientRect and GetStatusTextW
33 * -- FIXMEs + BUGS (search for them)
36 * -- ICC_ANIMATE_CLASS
41 * -- ICC_INTERNET_CLASSES
43 * -- ICC_LISTVIEW_CLASSES
44 * -- ICC_NATIVEFNTCTL_CLASS
45 * -- ICC_PAGESCROLLER_CLASS
46 * -- ICC_PROGRESS_CLASS
47 * -- ICC_STANDARD_CLASSES (not yet implemented)
49 * -- ICC_TREEVIEW_CLASSES
51 * -- ICC_USEREX_CLASSES
52 * -- ICC_WIN95_CLASSES
67 #define NO_SHLWAPI_STREAM
70 #include "wine/debug.h"
72 WINE_DEFAULT_DEBUG_CHANNEL(commctrl);
74 LRESULT WINAPI COMCTL32_SubclassProc (HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam);
76 LPWSTR COMCTL32_wSubclass = NULL;
77 HMODULE COMCTL32_hModule = 0;
78 LANGID COMCTL32_uiLang = MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL);
79 HBRUSH COMCTL32_hPattern55AABrush = NULL;
80 COMCTL32_SysColor comctl32_color;
82 static HBITMAP COMCTL32_hPattern55AABitmap = NULL;
84 static const WORD wPattern55AA[] =
86 0x5555, 0xaaaa, 0x5555, 0xaaaa,
87 0x5555, 0xaaaa, 0x5555, 0xaaaa
90 static const WCHAR strCC32SubclassInfo[] = {
91 'C','C','3','2','S','u','b','c','l','a','s','s','I','n','f','o',0
94 /***********************************************************************
97 * Initializes the internal 'COMCTL32.DLL'.
100 * hinstDLL [I] handle to the 'dlls' instance
102 * lpvReserved [I] reserverd, must be NULL
109 BOOL WINAPI DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved)
111 TRACE("%p,%x,%p\n", hinstDLL, fdwReason, lpvReserved);
114 case DLL_PROCESS_ATTACH:
115 DisableThreadLibraryCalls(hinstDLL);
117 COMCTL32_hModule = (HMODULE)hinstDLL;
119 /* add global subclassing atom (used by 'tooltip' and 'updown') */
120 COMCTL32_wSubclass = (LPWSTR)(DWORD_PTR)GlobalAddAtomW (strCC32SubclassInfo);
121 TRACE("Subclassing atom added: %p\n", COMCTL32_wSubclass);
123 /* create local pattern brush */
124 COMCTL32_hPattern55AABitmap = CreateBitmap (8, 8, 1, 1, wPattern55AA);
125 COMCTL32_hPattern55AABrush = CreatePatternBrush (COMCTL32_hPattern55AABitmap);
127 /* Get all the colors at DLL load */
128 COMCTL32_RefreshSysColors();
130 /* like comctl32 5.82+ register all the common control classes */
133 DATETIME_Register ();
137 IPADDRESS_Register ();
138 LISTVIEW_Register ();
139 MONTHCAL_Register ();
140 NATIVEFONT_Register ();
142 PROGRESS_Register ();
148 TOOLTIPS_Register ();
149 TRACKBAR_Register ();
150 TREEVIEW_Register ();
153 /* subclass user32 controls */
154 THEMING_Initialize ();
157 case DLL_PROCESS_DETACH:
158 /* clean up subclassing */
159 THEMING_Uninitialize();
161 /* unregister all common control classes */
162 ANIMATE_Unregister ();
163 COMBOEX_Unregister ();
164 DATETIME_Unregister ();
165 FLATSB_Unregister ();
166 HEADER_Unregister ();
167 HOTKEY_Unregister ();
168 IPADDRESS_Unregister ();
169 LISTVIEW_Unregister ();
170 MONTHCAL_Unregister ();
171 NATIVEFONT_Unregister ();
173 PROGRESS_Unregister ();
175 STATUS_Unregister ();
176 SYSLINK_Unregister ();
178 TOOLBAR_Unregister ();
179 TOOLTIPS_Unregister ();
180 TRACKBAR_Unregister ();
181 TREEVIEW_Unregister ();
182 UPDOWN_Unregister ();
184 /* delete local pattern brush */
185 DeleteObject (COMCTL32_hPattern55AABrush);
186 COMCTL32_hPattern55AABrush = NULL;
187 DeleteObject (COMCTL32_hPattern55AABitmap);
188 COMCTL32_hPattern55AABitmap = NULL;
190 /* delete global subclassing atom */
191 GlobalDeleteAtom (LOWORD(COMCTL32_wSubclass));
192 TRACE("Subclassing atom deleted: %p\n", COMCTL32_wSubclass);
193 COMCTL32_wSubclass = NULL;
201 /***********************************************************************
202 * MenuHelp [COMCTL32.2]
204 * Handles the setting of status bar help messages when the user
205 * selects menu items.
208 * uMsg [I] message (WM_MENUSELECT) (see NOTES)
209 * wParam [I] wParam of the message uMsg
210 * lParam [I] lParam of the message uMsg
211 * hMainMenu [I] handle to the application's main menu
212 * hInst [I] handle to the module that contains string resources
213 * hwndStatus [I] handle to the status bar window
214 * lpwIDs [I] pointer to an array of integers (see NOTES)
220 * The official documentation is incomplete!
221 * This is the correct documentation:
224 * MenuHelp() does NOT handle WM_COMMAND messages! It only handles
225 * WM_MENUSELECT messages.
228 * (will be written ...)
232 MenuHelp (UINT uMsg, WPARAM wParam, LPARAM lParam, HMENU hMainMenu,
233 HINSTANCE hInst, HWND hwndStatus, UINT* lpwIDs)
237 if (!IsWindow (hwndStatus))
242 TRACE("WM_MENUSELECT wParam=0x%lX lParam=0x%lX\n",
245 if ((HIWORD(wParam) == 0xFFFF) && (lParam == 0)) {
246 /* menu was closed */
247 TRACE("menu was closed!\n");
248 SendMessageW (hwndStatus, SB_SIMPLE, FALSE, 0);
251 /* menu item was selected */
252 if (HIWORD(wParam) & MF_POPUP)
253 uMenuID = (UINT)*(lpwIDs+1);
255 uMenuID = (UINT)LOWORD(wParam);
256 TRACE("uMenuID = %u\n", uMenuID);
261 if (!LoadStringW (hInst, uMenuID, szText, sizeof(szText)/sizeof(szText[0])))
264 SendMessageW (hwndStatus, SB_SETTEXTW,
265 255 | SBT_NOBORDERS, (LPARAM)szText);
266 SendMessageW (hwndStatus, SB_SIMPLE, TRUE, 0);
272 TRACE("WM_COMMAND wParam=0x%lX lParam=0x%lX\n",
274 /* WM_COMMAND is not invalid since it is documented
275 * in the windows api reference. So don't output
276 * any FIXME for WM_COMMAND
278 WARN("We don't care about the WM_COMMAND\n");
282 FIXME("Invalid Message 0x%x!\n", uMsg);
288 /***********************************************************************
289 * ShowHideMenuCtl [COMCTL32.3]
291 * Shows or hides controls and updates the corresponding menu item.
294 * hwnd [I] handle to the client window.
295 * uFlags [I] menu command id.
296 * lpInfo [I] pointer to an array of integers. (See NOTES.)
303 * The official documentation is incomplete!
304 * This is the correct documentation:
307 * Handle to the window that contains the menu and controls.
310 * Identifier of the menu item to receive or lose a check mark.
313 * The array of integers contains pairs of values. BOTH values of
314 * the first pair must be the handles to the application's main menu.
315 * Each subsequent pair consists of a menu id and control id.
319 ShowHideMenuCtl (HWND hwnd, UINT_PTR uFlags, LPINT lpInfo)
323 TRACE("%p, %lx, %p\n", hwnd, uFlags, lpInfo);
328 if (!(lpInfo[0]) || !(lpInfo[1]))
331 /* search for control */
332 lpMenuId = &lpInfo[2];
333 while (*lpMenuId != uFlags)
336 if (GetMenuState ((HMENU)(DWORD_PTR)lpInfo[1], uFlags, MF_BYCOMMAND) & MFS_CHECKED) {
337 /* uncheck menu item */
338 CheckMenuItem ((HMENU)(DWORD_PTR)lpInfo[0], *lpMenuId, MF_BYCOMMAND | MF_UNCHECKED);
342 SetWindowPos (GetDlgItem (hwnd, *lpMenuId), 0, 0, 0, 0, 0,
346 /* check menu item */
347 CheckMenuItem ((HMENU)(DWORD_PTR)lpInfo[0], *lpMenuId, MF_BYCOMMAND | MF_CHECKED);
351 SetWindowPos (GetDlgItem (hwnd, *lpMenuId), 0, 0, 0, 0, 0,
359 /***********************************************************************
360 * GetEffectiveClientRect [COMCTL32.4]
362 * Calculates the coordinates of a rectangle in the client area.
365 * hwnd [I] handle to the client window.
366 * lpRect [O] pointer to the rectangle of the client window
367 * lpInfo [I] pointer to an array of integers (see NOTES)
373 * The official documentation is incomplete!
374 * This is the correct documentation:
377 * (will be written ...)
381 GetEffectiveClientRect (HWND hwnd, LPRECT lpRect, const INT *lpInfo)
387 TRACE("(%p %p %p)\n",
388 hwnd, lpRect, lpInfo);
390 GetClientRect (hwnd, lpRect);
398 hwndCtrl = GetDlgItem (hwnd, *lpRun);
399 if (GetWindowLongW (hwndCtrl, GWL_STYLE) & WS_VISIBLE) {
400 TRACE("control id 0x%x\n", *lpRun);
401 GetWindowRect (hwndCtrl, &rcCtrl);
402 MapWindowPoints (NULL, hwnd, (LPPOINT)&rcCtrl, 2);
403 SubtractRect (lpRect, lpRect, &rcCtrl);
410 /***********************************************************************
411 * DrawStatusTextW [COMCTL32.@]
413 * Draws text with borders, like in a status bar.
416 * hdc [I] handle to the window's display context
417 * lprc [I] pointer to a rectangle
418 * text [I] pointer to the text
419 * style [I] drawing style
425 * The style variable can have one of the following values:
426 * (will be written ...)
429 void WINAPI DrawStatusTextW (HDC hdc, LPCRECT lprc, LPCWSTR text, UINT style)
432 UINT border = BDR_SUNKENOUTER;
434 if (style & SBT_POPOUT)
435 border = BDR_RAISEDOUTER;
436 else if (style & SBT_NOBORDERS)
439 DrawEdge (hdc, &r, border, BF_RECT|BF_ADJUST);
443 int oldbkmode = SetBkMode (hdc, TRANSPARENT);
444 UINT align = DT_LEFT;
454 if (style & SBT_RTLREADING)
455 FIXME("Unsupported RTL style!\n");
456 DrawTextW (hdc, text, -1, &r, align|DT_VCENTER|DT_SINGLELINE|DT_NOPREFIX);
457 SetBkMode(hdc, oldbkmode);
462 /***********************************************************************
463 * DrawStatusText [COMCTL32.@]
464 * DrawStatusTextA [COMCTL32.5]
466 * Draws text with borders, like in a status bar.
469 * hdc [I] handle to the window's display context
470 * lprc [I] pointer to a rectangle
471 * text [I] pointer to the text
472 * style [I] drawing style
478 void WINAPI DrawStatusTextA (HDC hdc, LPCRECT lprc, LPCSTR text, UINT style)
484 if ( (len = MultiByteToWideChar( CP_ACP, 0, text, -1, NULL, 0 )) ) {
485 if ( (textW = Alloc( len * sizeof(WCHAR) )) )
486 MultiByteToWideChar( CP_ACP, 0, text, -1, textW, len );
489 DrawStatusTextW( hdc, lprc, textW, style );
494 /***********************************************************************
495 * CreateStatusWindow [COMCTL32.@]
496 * CreateStatusWindowA [COMCTL32.6]
498 * Creates a status bar
501 * style [I] window style
502 * text [I] pointer to the window text
503 * parent [I] handle to the parent window
504 * wid [I] control id of the status bar
507 * Success: handle to the status window
512 CreateStatusWindowA (LONG style, LPCSTR text, HWND parent, UINT wid)
514 return CreateWindowA(STATUSCLASSNAMEA, text, style,
515 CW_USEDEFAULT, CW_USEDEFAULT,
516 CW_USEDEFAULT, CW_USEDEFAULT,
517 parent, (HMENU)(DWORD_PTR)wid, 0, 0);
521 /***********************************************************************
522 * CreateStatusWindowW [COMCTL32.@]
524 * Creates a status bar control
527 * style [I] window style
528 * text [I] pointer to the window text
529 * parent [I] handle to the parent window
530 * wid [I] control id of the status bar
533 * Success: handle to the status window
538 CreateStatusWindowW (LONG style, LPCWSTR text, HWND parent, UINT wid)
540 return CreateWindowW(STATUSCLASSNAMEW, text, style,
541 CW_USEDEFAULT, CW_USEDEFAULT,
542 CW_USEDEFAULT, CW_USEDEFAULT,
543 parent, (HMENU)(DWORD_PTR)wid, 0, 0);
547 /***********************************************************************
548 * CreateUpDownControl [COMCTL32.16]
550 * Creates an up-down control
553 * style [I] window styles
554 * x [I] horizontal position of the control
555 * y [I] vertical position of the control
556 * cx [I] with of the control
557 * cy [I] height of the control
558 * parent [I] handle to the parent window
559 * id [I] the control's identifier
560 * inst [I] handle to the application's module instance
561 * buddy [I] handle to the buddy window, can be NULL
562 * maxVal [I] upper limit of the control
563 * minVal [I] lower limit of the control
564 * curVal [I] current value of the control
567 * Success: handle to the updown control
572 CreateUpDownControl (DWORD style, INT x, INT y, INT cx, INT cy,
573 HWND parent, INT id, HINSTANCE inst,
574 HWND buddy, INT maxVal, INT minVal, INT curVal)
577 CreateWindowW (UPDOWN_CLASSW, 0, style, x, y, cx, cy,
578 parent, (HMENU)(DWORD_PTR)id, inst, 0);
580 SendMessageW (hUD, UDM_SETBUDDY, (WPARAM)buddy, 0);
581 SendMessageW (hUD, UDM_SETRANGE, 0, MAKELONG(maxVal, minVal));
582 SendMessageW (hUD, UDM_SETPOS, 0, MAKELONG(curVal, 0));
589 /***********************************************************************
590 * InitCommonControls [COMCTL32.17]
592 * Registers the common controls.
601 * This function is just a dummy - all the controls are registered at
602 * the DLL's initialization. See InitCommonContolsEx for details.
606 InitCommonControls (void)
611 /***********************************************************************
612 * InitCommonControlsEx [COMCTL32.@]
614 * Registers the common controls.
617 * lpInitCtrls [I] pointer to an INITCOMMONCONTROLS structure.
624 * Probaly all versions of comctl32 initializes the Win95 controls in DllMain
625 * during DLL initializaiton. Starting from comctl32 v5.82 all the controls
626 * are initialized there. We follow this behaviour and this function is just
629 * Note: when writing programs under Windows, if you don't call any function
630 * from comctl32 the linker may not link this DLL. If InitCommonControlsEx
631 * was the only comctl32 function you were calling and you remove it you may
632 * have a false impression that InitCommonControlsEx actually did something.
636 InitCommonControlsEx (const INITCOMMONCONTROLSEX *lpInitCtrls)
638 if (!lpInitCtrls || lpInitCtrls->dwSize != sizeof(INITCOMMONCONTROLSEX))
641 TRACE("(0x%08x)\n", lpInitCtrls->dwICC);
646 /***********************************************************************
647 * CreateToolbarEx [COMCTL32.@]
649 * Creates a toolbar window.
667 * Success: handle to the tool bar control
672 CreateToolbarEx (HWND hwnd, DWORD style, UINT wID, INT nBitmaps,
673 HINSTANCE hBMInst, UINT wBMID, LPCTBBUTTON lpButtons,
674 INT iNumButtons, INT dxButton, INT dyButton,
675 INT dxBitmap, INT dyBitmap, UINT uStructSize)
680 CreateWindowExW(0, TOOLBARCLASSNAMEW, NULL, style|WS_CHILD, 0,0,100,30,
681 hwnd, (HMENU)(DWORD_PTR)wID, COMCTL32_hModule, NULL);
685 SendMessageW (hwndTB, TB_BUTTONSTRUCTSIZE, (WPARAM)uStructSize, 0);
687 /* set bitmap and button size */
688 /*If CreateToolbarEx receives 0, windows sets default values*/
693 if (dxBitmap == 0 || dyBitmap == 0)
694 dxBitmap = dyBitmap = 16;
695 SendMessageW(hwndTB, TB_SETBITMAPSIZE, 0, MAKELPARAM(dxBitmap, dyBitmap));
701 /* TB_SETBUTTONSIZE -> TB_SETBITMAPSIZE bug introduced for Windows compatibility */
702 if (dxButton != 0 && dyButton != 0)
703 SendMessageW(hwndTB, TB_SETBITMAPSIZE, 0, MAKELPARAM(dxButton, dyButton));
707 if (nBitmaps > 0 || hBMInst == HINST_COMMCTRL)
709 tbab.hInst = hBMInst;
712 SendMessageW (hwndTB, TB_ADDBITMAP, (WPARAM)nBitmaps, (LPARAM)&tbab);
716 SendMessageW (hwndTB, TB_ADDBUTTONSW,
717 (WPARAM)iNumButtons, (LPARAM)lpButtons);
724 /***********************************************************************
725 * CreateMappedBitmap [COMCTL32.8]
727 * Loads a bitmap resource using a colour map.
730 * hInstance [I] Handle to the module containing the bitmap.
731 * idBitmap [I] The bitmap resource ID.
732 * wFlags [I] CMB_MASKED for using bitmap as a mask or 0 for normal.
733 * lpColorMap [I] Colour information needed for the bitmap or NULL (uses system colours).
734 * iNumMaps [I] Number of COLORMAP's pointed to by lpColorMap.
737 * Success: handle to the new bitmap
742 CreateMappedBitmap (HINSTANCE hInstance, INT_PTR idBitmap, UINT wFlags,
743 LPCOLORMAP lpColorMap, INT iNumMaps)
747 const BITMAPINFOHEADER *lpBitmap;
748 LPBITMAPINFOHEADER lpBitmapInfo;
749 UINT nSize, nColorTableSize, iColor;
750 RGBQUAD *pColorTable;
751 INT i, iMaps, nWidth, nHeight;
754 LPCOLORMAP sysColorMap;
756 COLORMAP internalColorMap[4] =
757 {{0x000000, 0}, {0x808080, 0}, {0xC0C0C0, 0}, {0xFFFFFF, 0}};
759 /* initialize pointer to colortable and default color table */
762 sysColorMap = lpColorMap;
765 internalColorMap[0].to = GetSysColor (COLOR_BTNTEXT);
766 internalColorMap[1].to = GetSysColor (COLOR_BTNSHADOW);
767 internalColorMap[2].to = GetSysColor (COLOR_BTNFACE);
768 internalColorMap[3].to = GetSysColor (COLOR_BTNHIGHLIGHT);
770 sysColorMap = (LPCOLORMAP)internalColorMap;
773 hRsrc = FindResourceW (hInstance, (LPWSTR)idBitmap, (LPWSTR)RT_BITMAP);
776 hglb = LoadResource (hInstance, hRsrc);
779 lpBitmap = (LPBITMAPINFOHEADER)LockResource (hglb);
780 if (lpBitmap == NULL)
783 if (lpBitmap->biSize >= sizeof(BITMAPINFOHEADER) && lpBitmap->biClrUsed)
784 nColorTableSize = lpBitmap->biClrUsed;
785 else if (lpBitmap->biBitCount <= 8)
786 nColorTableSize = (1 << lpBitmap->biBitCount);
789 nSize = lpBitmap->biSize + nColorTableSize * sizeof(RGBQUAD);
790 lpBitmapInfo = (LPBITMAPINFOHEADER)GlobalAlloc (GMEM_FIXED, nSize);
791 if (lpBitmapInfo == NULL)
793 RtlMoveMemory (lpBitmapInfo, lpBitmap, nSize);
795 pColorTable = (RGBQUAD*)(((LPBYTE)lpBitmapInfo)+(UINT)lpBitmapInfo->biSize);
797 for (iColor = 0; iColor < nColorTableSize; iColor++) {
798 for (i = 0; i < iMaps; i++) {
799 cRef = RGB(pColorTable[iColor].rgbRed,
800 pColorTable[iColor].rgbGreen,
801 pColorTable[iColor].rgbBlue);
802 if ( cRef == sysColorMap[i].from) {
804 if (wFlags & CBS_MASKED) {
805 if (sysColorMap[i].to != COLOR_BTNTEXT)
806 pColorTable[iColor] = RGB(255, 255, 255);
810 pColorTable[iColor].rgbBlue = GetBValue(sysColorMap[i].to);
811 pColorTable[iColor].rgbGreen = GetGValue(sysColorMap[i].to);
812 pColorTable[iColor].rgbRed = GetRValue(sysColorMap[i].to);
817 nWidth = (INT)lpBitmapInfo->biWidth;
818 nHeight = (INT)lpBitmapInfo->biHeight;
819 hdcScreen = GetDC (NULL);
820 hbm = CreateCompatibleBitmap (hdcScreen, nWidth, nHeight);
822 HDC hdcDst = CreateCompatibleDC (hdcScreen);
823 HBITMAP hbmOld = SelectObject (hdcDst, hbm);
824 const BYTE *lpBits = (const BYTE *)(lpBitmap + 1);
825 lpBits += nColorTableSize * sizeof(RGBQUAD);
826 StretchDIBits (hdcDst, 0, 0, nWidth, nHeight, 0, 0, nWidth, nHeight,
827 lpBits, (LPBITMAPINFO)lpBitmapInfo, DIB_RGB_COLORS,
829 SelectObject (hdcDst, hbmOld);
832 ReleaseDC (NULL, hdcScreen);
833 GlobalFree ((HGLOBAL)lpBitmapInfo);
840 /***********************************************************************
841 * CreateToolbar [COMCTL32.7]
843 * Creates a toolbar control.
856 * Success: handle to the tool bar control
860 * Do not use this functions anymore. Use CreateToolbarEx instead.
864 CreateToolbar (HWND hwnd, DWORD style, UINT wID, INT nBitmaps,
865 HINSTANCE hBMInst, UINT wBMID,
866 LPCTBBUTTON lpButtons,INT iNumButtons)
868 return CreateToolbarEx (hwnd, style | CCS_NODIVIDER, wID, nBitmaps,
869 hBMInst, wBMID, lpButtons,
870 iNumButtons, 0, 0, 0, 0, CCSIZEOF_STRUCT(TBBUTTON, dwData));
874 /***********************************************************************
875 * DllGetVersion [COMCTL32.@]
877 * Retrieves version information of the 'COMCTL32.DLL'
880 * pdvi [O] pointer to version information structure.
884 * Failure: E_INVALIDARG
887 * Returns version of a comctl32.dll from IE4.01 SP1.
890 HRESULT WINAPI DllGetVersion (DLLVERSIONINFO *pdvi)
892 if (pdvi->cbSize != sizeof(DLLVERSIONINFO)) {
893 WARN("wrong DLLVERSIONINFO size from app\n");
897 pdvi->dwMajorVersion = COMCTL32_VERSION;
898 pdvi->dwMinorVersion = COMCTL32_VERSION_MINOR;
899 pdvi->dwBuildNumber = 2919;
900 pdvi->dwPlatformID = 6304;
902 TRACE("%u.%u.%u.%u\n",
903 pdvi->dwMajorVersion, pdvi->dwMinorVersion,
904 pdvi->dwBuildNumber, pdvi->dwPlatformID);
909 /***********************************************************************
910 * DllInstall (COMCTL32.@)
912 * Installs the ComCtl32 DLL.
916 * Failure: A HRESULT error
918 HRESULT WINAPI DllInstall(BOOL bInstall, LPCWSTR cmdline)
920 FIXME("(%s, %s): stub\n", bInstall?"TRUE":"FALSE",
921 debugstr_w(cmdline));
926 /***********************************************************************
927 * _TrackMouseEvent [COMCTL32.@]
929 * Requests notification of mouse events
931 * During mouse tracking WM_MOUSEHOVER or WM_MOUSELEAVE events are posted
932 * to the hwnd specified in the ptme structure. After the event message
933 * is posted to the hwnd, the entry in the queue is removed.
935 * If the current hwnd isn't ptme->hwndTrack the TME_HOVER flag is completely
936 * ignored. The TME_LEAVE flag results in a WM_MOUSELEAVE message being posted
937 * immediately and the TME_LEAVE flag being ignored.
940 * ptme [I,O] pointer to TRACKMOUSEEVENT information structure.
946 * IMPLEMENTATION moved to USER32.TrackMouseEvent
951 _TrackMouseEvent (TRACKMOUSEEVENT *ptme)
953 return TrackMouseEvent (ptme);
956 /*************************************************************************
957 * GetMUILanguage [COMCTL32.@]
959 * Returns the user interface language in use by the current process.
962 * Language ID in use by the current process.
964 LANGID WINAPI GetMUILanguage (VOID)
966 return COMCTL32_uiLang;
970 /*************************************************************************
971 * InitMUILanguage [COMCTL32.@]
973 * Sets the user interface language to be used by the current process.
978 VOID WINAPI InitMUILanguage (LANGID uiLang)
980 COMCTL32_uiLang = uiLang;
984 /***********************************************************************
985 * SetWindowSubclass [COMCTL32.410]
987 * Starts a window subclass
990 * hWnd [in] handle to window subclass.
991 * pfnSubclass [in] Pointer to new window procedure.
992 * uIDSubclass [in] Unique identifier of sublass together with pfnSubclass.
993 * dwRef [in] Reference data to pass to window procedure.
1000 * If an application manually subclasses a window after subclassing it with
1001 * this API and then with this API again, then none of the previous
1002 * subclasses get called or the origional window procedure.
1005 BOOL WINAPI SetWindowSubclass (HWND hWnd, SUBCLASSPROC pfnSubclass,
1006 UINT_PTR uIDSubclass, DWORD_PTR dwRef)
1008 LPSUBCLASS_INFO stack;
1009 LPSUBCLASSPROCS proc;
1011 TRACE ("(%p, %p, %lx, %lx)\n", hWnd, pfnSubclass, uIDSubclass, dwRef);
1013 /* Since the window procedure that we set here has two additional arguments,
1014 * we can't simply set it as the new window procedure of the window. So we
1015 * set our own window procedure and then calculate the other two arguments
1018 /* See if we have been called for this window */
1019 stack = (LPSUBCLASS_INFO)GetPropW (hWnd, COMCTL32_wSubclass);
1021 /* allocate stack */
1022 stack = Alloc (sizeof(SUBCLASS_INFO));
1024 ERR ("Failed to allocate our Subclassing stack\n");
1027 SetPropW (hWnd, COMCTL32_wSubclass, (HANDLE)stack);
1029 /* set window procedure to our own and save the current one */
1030 if (IsWindowUnicode (hWnd))
1031 stack->origproc = (WNDPROC)SetWindowLongPtrW (hWnd, GWLP_WNDPROC,
1032 (DWORD_PTR)COMCTL32_SubclassProc);
1034 stack->origproc = (WNDPROC)SetWindowLongPtrA (hWnd, GWLP_WNDPROC,
1035 (DWORD_PTR)COMCTL32_SubclassProc);
1038 /* Check to see if we have called this function with the same uIDSubClass
1039 * and pfnSubclass */
1040 proc = stack->SubclassProcs;
1042 if ((proc->id == uIDSubclass) &&
1043 (proc->subproc == pfnSubclass)) {
1051 proc = Alloc(sizeof(SUBCLASSPROCS));
1053 ERR ("Failed to allocate subclass entry in stack\n");
1054 if (IsWindowUnicode (hWnd))
1055 SetWindowLongPtrW (hWnd, GWLP_WNDPROC, (DWORD_PTR)stack->origproc);
1057 SetWindowLongPtrA (hWnd, GWLP_WNDPROC, (DWORD_PTR)stack->origproc);
1059 RemovePropW( hWnd, COMCTL32_wSubclass );
1063 proc->subproc = pfnSubclass;
1065 proc->id = uIDSubclass;
1066 proc->next = stack->SubclassProcs;
1067 stack->SubclassProcs = proc;
1073 /***********************************************************************
1074 * GetWindowSubclass [COMCTL32.411]
1076 * Gets the Reference data from a subclass.
1079 * hWnd [in] Handle to window which were subclassing
1080 * pfnSubclass [in] Pointer to the subclass procedure
1081 * uID [in] Unique indentifier of the subclassing procedure
1082 * pdwRef [out] Pointer to the reference data
1089 BOOL WINAPI GetWindowSubclass (HWND hWnd, SUBCLASSPROC pfnSubclass,
1090 UINT_PTR uID, DWORD_PTR *pdwRef)
1092 const SUBCLASS_INFO *stack;
1093 const SUBCLASSPROCS *proc;
1095 TRACE ("(%p, %p, %lx, %p)\n", hWnd, pfnSubclass, uID, pdwRef);
1097 /* See if we have been called for this window */
1098 stack = (LPSUBCLASS_INFO)GetPropW (hWnd, COMCTL32_wSubclass);
1102 proc = stack->SubclassProcs;
1104 if ((proc->id == uID) &&
1105 (proc->subproc == pfnSubclass)) {
1106 *pdwRef = proc->ref;
1116 /***********************************************************************
1117 * RemoveWindowSubclass [COMCTL32.412]
1119 * Removes a window subclass.
1122 * hWnd [in] Handle to the window were subclassing
1123 * pfnSubclass [in] Pointer to the subclass procedure
1124 * uID [in] Unique identifier of this subclass
1131 BOOL WINAPI RemoveWindowSubclass(HWND hWnd, SUBCLASSPROC pfnSubclass, UINT_PTR uID)
1133 LPSUBCLASS_INFO stack;
1134 LPSUBCLASSPROCS prevproc = NULL;
1135 LPSUBCLASSPROCS proc;
1138 TRACE ("(%p, %p, %lx)\n", hWnd, pfnSubclass, uID);
1140 /* Find the Subclass to remove */
1141 stack = (LPSUBCLASS_INFO)GetPropW (hWnd, COMCTL32_wSubclass);
1145 proc = stack->SubclassProcs;
1147 if ((proc->id == uID) &&
1148 (proc->subproc == pfnSubclass)) {
1151 stack->SubclassProcs = proc->next;
1153 prevproc->next = proc->next;
1155 if (stack->stackpos == proc)
1156 stack->stackpos = stack->stackpos->next;
1166 if (!stack->SubclassProcs && !stack->running) {
1167 TRACE("Last Subclass removed, cleaning up\n");
1168 /* clean up our heap and reset the origional window procedure */
1169 if (IsWindowUnicode (hWnd))
1170 SetWindowLongPtrW (hWnd, GWLP_WNDPROC, (DWORD_PTR)stack->origproc);
1172 SetWindowLongPtrA (hWnd, GWLP_WNDPROC, (DWORD_PTR)stack->origproc);
1174 RemovePropW( hWnd, COMCTL32_wSubclass );
1180 /***********************************************************************
1181 * COMCTL32_SubclassProc (internal)
1183 * Window procedure for all subclassed windows.
1184 * Saves the current subclassing stack position to support nested messages
1186 LRESULT WINAPI COMCTL32_SubclassProc (HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
1188 LPSUBCLASS_INFO stack;
1189 LPSUBCLASSPROCS proc;
1192 TRACE ("(%p, 0x%08x, 0x%08lx, 0x%08lx)\n", hWnd, uMsg, wParam, lParam);
1194 stack = (LPSUBCLASS_INFO)GetPropW (hWnd, COMCTL32_wSubclass);
1196 ERR ("Our sub classing stack got erased for %p!! Nothing we can do\n", hWnd);
1200 /* Save our old stackpos to properly handle nested messages */
1201 proc = stack->stackpos;
1202 stack->stackpos = stack->SubclassProcs;
1204 ret = DefSubclassProc(hWnd, uMsg, wParam, lParam);
1206 stack->stackpos = proc;
1208 if (!stack->SubclassProcs && !stack->running) {
1209 TRACE("Last Subclass removed, cleaning up\n");
1210 /* clean up our heap and reset the origional window procedure */
1211 if (IsWindowUnicode (hWnd))
1212 SetWindowLongPtrW (hWnd, GWLP_WNDPROC, (DWORD_PTR)stack->origproc);
1214 SetWindowLongPtrA (hWnd, GWLP_WNDPROC, (DWORD_PTR)stack->origproc);
1216 RemovePropW( hWnd, COMCTL32_wSubclass );
1221 /***********************************************************************
1222 * DefSubclassProc [COMCTL32.413]
1224 * Calls the next window procedure (ie. the one before this subclass)
1227 * hWnd [in] The window that we're subclassing
1229 * wParam [in] WPARAM
1230 * lParam [in] LPARAM
1237 LRESULT WINAPI DefSubclassProc (HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
1239 LPSUBCLASS_INFO stack;
1242 TRACE ("(%p, 0x%08x, 0x%08lx, 0x%08lx)\n", hWnd, uMsg, wParam, lParam);
1244 /* retrieve our little stack from the Properties */
1245 stack = (LPSUBCLASS_INFO)GetPropW (hWnd, COMCTL32_wSubclass);
1247 ERR ("Our sub classing stack got erased for %p!! Nothing we can do\n", hWnd);
1251 /* If we are at the end of stack then we have to call the original
1252 * window procedure */
1253 if (!stack->stackpos) {
1254 if (IsWindowUnicode (hWnd))
1255 ret = CallWindowProcW (stack->origproc, hWnd, uMsg, wParam, lParam);
1257 ret = CallWindowProcA (stack->origproc, hWnd, uMsg, wParam, lParam);
1259 const SUBCLASSPROCS *proc = stack->stackpos;
1260 stack->stackpos = stack->stackpos->next;
1261 /* call the Subclass procedure from the stack */
1262 ret = proc->subproc (hWnd, uMsg, wParam, lParam,
1263 proc->id, proc->ref);
1270 /***********************************************************************
1271 * COMCTL32_CreateToolTip [NOT AN API]
1273 * Creates a tooltip for the control specified in hwnd and does all
1274 * necessary setup and notifications.
1277 * hwndOwner [I] Handle to the window that will own the tool tip.
1280 * Success: Handle of tool tip window.
1285 COMCTL32_CreateToolTip(HWND hwndOwner)
1289 hwndToolTip = CreateWindowExW(0, TOOLTIPS_CLASSW, NULL, WS_POPUP,
1290 CW_USEDEFAULT, CW_USEDEFAULT,
1291 CW_USEDEFAULT, CW_USEDEFAULT, hwndOwner,
1294 /* Send NM_TOOLTIPSCREATED notification */
1297 NMTOOLTIPSCREATED nmttc;
1298 /* true owner can be different if hwndOwner is a child window */
1299 HWND hwndTrueOwner = GetWindow(hwndToolTip, GW_OWNER);
1300 nmttc.hdr.hwndFrom = hwndTrueOwner;
1301 nmttc.hdr.idFrom = GetWindowLongPtrW(hwndTrueOwner, GWLP_ID);
1302 nmttc.hdr.code = NM_TOOLTIPSCREATED;
1303 nmttc.hwndToolTips = hwndToolTip;
1305 SendMessageW(GetParent(hwndTrueOwner), WM_NOTIFY,
1306 (WPARAM)GetWindowLongPtrW(hwndTrueOwner, GWLP_ID),
1314 /***********************************************************************
1315 * COMCTL32_RefreshSysColors [NOT AN API]
1317 * Invoked on any control recognizing a WM_SYSCOLORCHANGE message to
1318 * refresh the color values in the color structure
1328 COMCTL32_RefreshSysColors(void)
1330 comctl32_color.clrBtnHighlight = GetSysColor (COLOR_BTNHIGHLIGHT);
1331 comctl32_color.clrBtnShadow = GetSysColor (COLOR_BTNSHADOW);
1332 comctl32_color.clrBtnText = GetSysColor (COLOR_BTNTEXT);
1333 comctl32_color.clrBtnFace = GetSysColor (COLOR_BTNFACE);
1334 comctl32_color.clrHighlight = GetSysColor (COLOR_HIGHLIGHT);
1335 comctl32_color.clrHighlightText = GetSysColor (COLOR_HIGHLIGHTTEXT);
1336 comctl32_color.clr3dHilight = GetSysColor (COLOR_3DHILIGHT);
1337 comctl32_color.clr3dShadow = GetSysColor (COLOR_3DSHADOW);
1338 comctl32_color.clr3dDkShadow = GetSysColor (COLOR_3DDKSHADOW);
1339 comctl32_color.clr3dFace = GetSysColor (COLOR_3DFACE);
1340 comctl32_color.clrWindow = GetSysColor (COLOR_WINDOW);
1341 comctl32_color.clrWindowText = GetSysColor (COLOR_WINDOWTEXT);
1342 comctl32_color.clrGrayText = GetSysColor (COLOR_GRAYTEXT);
1343 comctl32_color.clrActiveCaption = GetSysColor (COLOR_ACTIVECAPTION);
1344 comctl32_color.clrInfoBk = GetSysColor (COLOR_INFOBK);
1345 comctl32_color.clrInfoText = GetSysColor (COLOR_INFOTEXT);
1348 /***********************************************************************
1349 * COMCTL32_DrawInsertMark [NOT AN API]
1351 * Draws an insertion mark (which looks similar to an 'I').
1354 * hDC [I] Device context to draw onto.
1355 * lpRect [I] Co-ordinates of insertion mark.
1356 * clrInsertMark [I] Colour of the insertion mark.
1357 * bHorizontal [I] True if insert mark should be drawn horizontally,
1358 * vertical otherwise.
1364 * Draws up to but not including the bottom co-ordinate when drawing
1365 * vertically or the right co-ordinate when horizontal.
1367 void COMCTL32_DrawInsertMark(HDC hDC, const RECT *lpRect, COLORREF clrInsertMark, BOOL bHorizontal)
1369 HPEN hPen = CreatePen(PS_SOLID, 1, clrInsertMark);
1371 static const DWORD adwPolyPoints[] = {4,4,4};
1372 LONG lCentre = (bHorizontal ?
1373 lpRect->top + (lpRect->bottom - lpRect->top)/2 :
1374 lpRect->left + (lpRect->right - lpRect->left)/2);
1375 LONG l1 = (bHorizontal ? lpRect->left : lpRect->top);
1376 LONG l2 = (bHorizontal ? lpRect->right : lpRect->bottom);
1377 const POINT aptInsertMark[] =
1379 /* top (V) or left (H) arrow */
1383 {lCentre + 1, l1 + 2},
1387 {lCentre + 1, l1 - 1},
1388 {lCentre + 1, l2 - 2},
1389 /* bottom (V) or right (H) arrow */
1391 {lCentre - 2, l2 - 1},
1392 {lCentre + 3, l2 - 1},
1393 {lCentre + 1, l2 - 3},
1395 hOldPen = SelectObject(hDC, hPen);
1396 PolyPolyline(hDC, aptInsertMark, adwPolyPoints, sizeof(adwPolyPoints)/sizeof(adwPolyPoints[0]));
1397 SelectObject(hDC, hOldPen);
1401 /***********************************************************************
1402 * COMCTL32_EnsureBitmapSize [internal]
1404 * If needed, enlarge the bitmap so that the width is at least cxMinWidth and
1405 * the height is at least cyMinHeight. If the bitmap already has these
1406 * dimensions nothing changes.
1409 * hBitmap [I/O] Bitmap to modify. The handle may change
1410 * cxMinWidth [I] If the width of the bitmap is smaller, then it will
1411 * be enlarged to this value
1412 * cyMinHeight [I] If the height of the bitmap is smaller, then it will
1413 * be enlarged to this value
1414 * cyBackground [I] The color with which the new area will be filled
1419 void COMCTL32_EnsureBitmapSize(HBITMAP *pBitmap, int cxMinWidth, int cyMinHeight, COLORREF crBackground)
1424 HBITMAP hNewDCBitmap, hOldDCBitmap;
1428 if (!GetObjectW(*pBitmap, sizeof(BITMAP), &bmp))
1430 cxNew = (cxMinWidth > bmp.bmWidth ? cxMinWidth : bmp.bmWidth);
1431 cyNew = (cyMinHeight > bmp.bmHeight ? cyMinHeight : bmp.bmHeight);
1432 if (cxNew == bmp.bmWidth && cyNew == bmp.bmHeight)
1435 hdcNew = CreateCompatibleDC(NULL);
1436 hNewBitmap = CreateBitmap(cxNew, cyNew, bmp.bmPlanes, bmp.bmBitsPixel, NULL);
1437 hNewDCBitmap = SelectObject(hdcNew, hNewBitmap);
1438 hNewDCBrush = SelectObject(hdcNew, CreateSolidBrush(crBackground));
1440 hdcOld = CreateCompatibleDC(NULL);
1441 hOldDCBitmap = SelectObject(hdcOld, *pBitmap);
1443 BitBlt(hdcNew, 0, 0, bmp.bmWidth, bmp.bmHeight, hdcOld, 0, 0, SRCCOPY);
1444 if (bmp.bmWidth < cxMinWidth)
1445 PatBlt(hdcNew, bmp.bmWidth, 0, cxNew, bmp.bmHeight, PATCOPY);
1446 if (bmp.bmHeight < cyMinHeight)
1447 PatBlt(hdcNew, 0, bmp.bmHeight, bmp.bmWidth, cyNew, PATCOPY);
1448 if (bmp.bmWidth < cxMinWidth && bmp.bmHeight < cyMinHeight)
1449 PatBlt(hdcNew, bmp.bmWidth, bmp.bmHeight, cxNew, cyNew, PATCOPY);
1451 SelectObject(hdcNew, hNewDCBitmap);
1452 DeleteObject(SelectObject(hdcNew, hNewDCBrush));
1454 SelectObject(hdcOld, hOldDCBitmap);
1457 DeleteObject(*pBitmap);
1458 *pBitmap = hNewBitmap;
1462 /***********************************************************************
1463 * MirrorIcon [COMCTL32.414]
1465 * Mirrors an icon so that it will appear correctly on a mirrored DC.
1468 * phicon1 [I/O] Icon.
1469 * phicon2 [I/O] Icon.
1475 BOOL WINAPI MirrorIcon(HICON *phicon1, HICON *phicon2)
1477 FIXME("(%p, %p): stub\n", phicon1, phicon2);
1481 static inline int IsDelimiter(WCHAR c)
1494 static int CALLBACK PathWordBreakProc(LPCWSTR lpch, int ichCurrent, int cch, int code)
1496 if (code == WB_ISDELIMITER)
1497 return IsDelimiter(lpch[ichCurrent]);
1500 int dir = (code == WB_LEFT) ? -1 : 1;
1501 for(; 0 <= ichCurrent && ichCurrent < cch; ichCurrent += dir)
1502 if (IsDelimiter(lpch[ichCurrent])) return ichCurrent;
1507 /***********************************************************************
1508 * SetPathWordBreakProc [COMCTL32.384]
1510 * Sets the word break procedure for an edit control to one that understands
1511 * paths so that the user can jump over directories.
1514 * hwnd [I] Handle to edit control.
1515 * bSet [I] If this is TRUE then the word break proc is set, otherwise it is removed.
1518 * Result from EM_SETWORDBREAKPROC message.
1520 LRESULT WINAPI SetPathWordBreakProc(HWND hwnd, BOOL bSet)
1522 return SendMessageW(hwnd, EM_SETWORDBREAKPROC, 0,
1523 (LPARAM)(bSet ? PathWordBreakProc : NULL));
1526 /***********************************************************************
1527 * DrawShadowText [COMCTL32.@]
1529 * Draw text with shadow.
1531 int WINAPI DrawShadowText(HDC hdc, LPCWSTR pszText, UINT cch, RECT *rect, DWORD dwFlags,
1532 COLORREF crText, COLORREF crShadow, int ixOffset, int iyOffset)
1534 FIXME("(%p, %s, %d, %p, %d, 0x%08x, 0x%08x, %d, %d): stub\n", hdc, debugstr_w(pszText), cch, rect, dwFlags,
1535 crText, crShadow, ixOffset, iyOffset);
1536 return DrawTextW(hdc, pszText, cch, rect, DT_LEFT);