2 * Copyright 1999 Juergen Schmied
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 * - many flags unimplemented
27 #define NONAMELESSUNION
28 #define NONAMELESSSTRUCT
30 #include "wine/debug.h"
31 #include "undocshell.h"
34 #include "shell32_main.h"
38 WINE_DEFAULT_DEBUG_CHANNEL(shell);
40 typedef struct tagbrowse_info
44 LPBROWSEINFOW lpBrowseInfo;
48 typedef struct tagTV_ITEMDATA
50 LPSHELLFOLDER lpsfParent; /* IShellFolder of the parent */
51 LPITEMIDLIST lpi; /* PIDL relativ to parent */
52 LPITEMIDLIST lpifq; /* Fully qualified PIDL */
53 IEnumIDList* pEnumIL; /* Children iterator */
54 } TV_ITEMDATA, *LPTV_ITEMDATA;
56 #define SUPPORTEDFLAGS (BIF_STATUSTEXT | \
57 BIF_BROWSEFORCOMPUTER | \
58 BIF_RETURNFSANCESTORS | \
59 BIF_RETURNONLYFSDIRS | \
60 BIF_BROWSEINCLUDEFILES)
62 static void FillTreeView(browse_info*, LPSHELLFOLDER,
63 LPITEMIDLIST, HTREEITEM, IEnumIDList*);
64 static HTREEITEM InsertTreeViewItem( browse_info*, IShellFolder *,
65 LPCITEMIDLIST, LPCITEMIDLIST, IEnumIDList*, HTREEITEM);
67 const WCHAR szBrowseFolderInfo[] = {
68 '_','_','W','I','N','E','_',
69 'B','R','S','F','O','L','D','E','R','D','L','G','_',
73 static inline DWORD BrowseFlagsToSHCONTF(UINT ulFlags)
75 return SHCONTF_FOLDERS | (ulFlags & BIF_BROWSEINCLUDEFILES ? SHCONTF_NONFOLDERS : 0);
78 static void browsefolder_callback( LPBROWSEINFOW lpBrowseInfo, HWND hWnd,
79 UINT msg, LPARAM param )
81 if (!lpBrowseInfo->lpfn)
83 lpBrowseInfo->lpfn( hWnd, msg, param, lpBrowseInfo->lParam );
86 /******************************************************************************
87 * InitializeTreeView [Internal]
89 * Called from WM_INITDIALOG handler.
92 * hwndParent [I] The BrowseForFolder dialog
93 * root [I] ITEMIDLIST of the root shell folder
95 static void InitializeTreeView( browse_info *info )
97 LPITEMIDLIST pidlParent, pidlChild;
98 HIMAGELIST hImageList;
100 IShellFolder *lpsfParent, *lpsfRoot;
101 IEnumIDList * pEnumChildren = NULL;
104 LPCITEMIDLIST root = info->lpBrowseInfo->pidlRoot;
106 TRACE("%p\n", info );
108 Shell_GetImageList(NULL, &hImageList);
111 TreeView_SetImageList( info->hwndTreeView, hImageList, 0 );
113 /* We want to call InsertTreeViewItem down the code, in order to insert
114 * the root item of the treeview. Due to InsertTreeViewItem's signature,
115 * we need the following to do this:
117 * + An ITEMIDLIST corresponding to _the parent_ of root.
118 * + An ITEMIDLIST, which is a relative path from root's parent to root
119 * (containing a single SHITEMID).
120 * + An IShellFolder interface pointer of root's parent folder.
122 * If root is 'Desktop', then root's parent is also 'Desktop'.
125 pidlParent = ILClone(root);
126 ILRemoveLastID(pidlParent);
127 pidlChild = ILClone(ILFindLastID(root));
129 if (_ILIsDesktop(pidlParent)) {
130 hr = SHGetDesktopFolder(&lpsfParent);
132 IShellFolder *lpsfDesktop;
133 hr = SHGetDesktopFolder(&lpsfDesktop);
134 if (!SUCCEEDED(hr)) {
135 WARN("SHGetDesktopFolder failed! hr = %08lx\n", hr);
138 hr = IShellFolder_BindToObject(lpsfDesktop, pidlParent, 0, &IID_IShellFolder, (LPVOID*)&lpsfParent);
139 IShellFolder_Release(lpsfDesktop);
142 if (!SUCCEEDED(hr)) {
143 WARN("Could not bind to parent shell folder! hr = %08lx\n", hr);
147 if (pidlChild && pidlChild->mkid.cb) {
148 hr = IShellFolder_BindToObject(lpsfParent, pidlChild, 0, &IID_IShellFolder, (LPVOID*)&lpsfRoot);
150 lpsfRoot = lpsfParent;
151 hr = IShellFolder_AddRef(lpsfParent);
154 if (!SUCCEEDED(hr)) {
155 WARN("Could not bind to root shell folder! hr = %08lx\n", hr);
156 IShellFolder_Release(lpsfParent);
160 flags = BrowseFlagsToSHCONTF( info->lpBrowseInfo->ulFlags );
161 hr = IShellFolder_EnumObjects( lpsfRoot, info->hWnd, flags, &pEnumChildren );
162 if (!SUCCEEDED(hr)) {
163 WARN("Could not get child iterator! hr = %08lx\n", hr);
164 IShellFolder_Release(lpsfParent);
165 IShellFolder_Release(lpsfRoot);
169 TreeView_DeleteAllItems( info->hwndTreeView );
170 item = InsertTreeViewItem( info, lpsfParent, pidlChild,
171 pidlParent, pEnumChildren, TVI_ROOT );
172 TreeView_Expand( info->hwndTreeView, item, TVE_EXPAND );
174 IShellFolder_Release(lpsfRoot);
175 IShellFolder_Release(lpsfParent);
178 static int GetIcon(LPITEMIDLIST lpi, UINT uFlags)
181 SHGetFileInfoW((LPCWSTR)lpi, 0 ,&sfi, sizeof(SHFILEINFOW), uFlags);
185 static void GetNormalAndSelectedIcons(LPITEMIDLIST lpifq, LPTVITEMW lpTV_ITEM)
187 LPITEMIDLIST pidlDesktop = NULL;
190 TRACE("%p %p\n",lpifq, lpTV_ITEM);
194 pidlDesktop = _ILCreateDesktop();
198 flags = SHGFI_PIDL | SHGFI_SYSICONINDEX | SHGFI_SMALLICON;
199 lpTV_ITEM->iImage = GetIcon( lpifq, flags );
201 flags = SHGFI_PIDL | SHGFI_SYSICONINDEX | SHGFI_SMALLICON | SHGFI_OPENICON;
202 lpTV_ITEM->iSelectedImage = GetIcon( lpifq, flags );
205 ILFree( pidlDesktop );
208 /******************************************************************************
211 * Query a shell folder for the display name of one of it's children
214 * lpsf [I] IShellFolder interface of the folder to be queried.
215 * lpi [I] ITEMIDLIST of the child, relative to parent
216 * dwFlags [I] as in IShellFolder::GetDisplayNameOf
217 * lpFriendlyName [O] The desired display name in unicode
223 static BOOL GetName(LPSHELLFOLDER lpsf, LPCITEMIDLIST lpi, DWORD dwFlags, LPWSTR lpFriendlyName)
228 TRACE("%p %p %lx %p\n", lpsf, lpi, dwFlags, lpFriendlyName);
229 if (SUCCEEDED(IShellFolder_GetDisplayNameOf(lpsf, lpi, dwFlags, &str)))
230 bSuccess = StrRetToStrNW(lpFriendlyName, MAX_PATH, &str, lpi);
234 TRACE("-- %s\n", debugstr_w(lpFriendlyName));
238 /******************************************************************************
239 * InsertTreeViewItem [Internal]
242 * info [I] data for the dialog
243 * lpsf [I] IShellFolder interface of the item's parent shell folder
244 * pidl [I] ITEMIDLIST of the child to insert, relativ to parent
245 * pidlParent [I] ITEMIDLIST of the parent shell folder
246 * pEnumIL [I] Iterator for the children of the item to be inserted
247 * hParent [I] The treeview-item that represents the parent shell folder
250 * Success: Handle to the created and inserted treeview-item
253 static HTREEITEM InsertTreeViewItem( browse_info *info, IShellFolder * lpsf,
254 LPCITEMIDLIST pidl, LPCITEMIDLIST pidlParent, IEnumIDList* pEnumIL,
258 TVINSERTSTRUCTW tvins;
259 WCHAR szBuff[MAX_PATH];
260 LPTV_ITEMDATA lptvid=0;
262 tvi.mask = TVIF_TEXT | TVIF_IMAGE | TVIF_SELECTEDIMAGE | TVIF_PARAM;
264 tvi.cChildren= pEnumIL ? 1 : 0;
265 tvi.mask |= TVIF_CHILDREN;
267 lptvid = SHAlloc( sizeof(TV_ITEMDATA) );
271 if (!GetName(lpsf, pidl, SHGDN_NORMAL, szBuff))
274 tvi.pszText = szBuff;
275 tvi.cchTextMax = MAX_PATH;
276 tvi.lParam = (LPARAM)lptvid;
278 IShellFolder_AddRef(lpsf);
279 lptvid->lpsfParent = lpsf;
280 lptvid->lpi = ILClone(pidl);
281 lptvid->lpifq = pidlParent ? ILCombine(pidlParent, pidl) : ILClone(pidl);
282 lptvid->pEnumIL = pEnumIL;
283 GetNormalAndSelectedIcons(lptvid->lpifq, &tvi);
286 tvins.hInsertAfter = NULL;
287 tvins.hParent = hParent;
289 return (HTREEITEM)TreeView_InsertItemW( info->hwndTreeView, &tvins );
292 /******************************************************************************
293 * FillTreeView [Internal]
295 * For each child (given by lpe) of the parent shell folder, which is given by
296 * lpsf and whose PIDL is pidl, insert a treeview-item right under hParent
299 * info [I] data for the dialog
300 * lpsf [I] IShellFolder interface of the parent shell folder
301 * pidl [I] ITEMIDLIST of the parent shell folder
302 * hParent [I] The treeview item that represents the parent shell folder
303 * lpe [I] An iterator for the children of the parent shell folder
305 static void FillTreeView( browse_info *info, IShellFolder * lpsf,
306 LPITEMIDLIST pidl, HTREEITEM hParent, IEnumIDList* lpe)
309 LPITEMIDLIST pidlTemp = 0;
312 HWND hwnd = GetParent( info->hwndTreeView );
314 TRACE("%p %p %p %p\n",lpsf, pidl, hParent, lpe);
316 /* No IEnumIDList -> No children */
320 SetCursor( LoadCursorA( 0, (LPSTR)IDC_WAIT ) );
322 while (NOERROR == IEnumIDList_Next(lpe,1,&pidlTemp,&ulFetched))
324 ULONG ulAttrs = SFGAO_HASSUBFOLDER | SFGAO_FOLDER;
325 IEnumIDList* pEnumIL = NULL;
326 IShellFolder* pSFChild = NULL;
327 IShellFolder_GetAttributesOf(lpsf, 1, (LPCITEMIDLIST*)&pidlTemp, &ulAttrs);
328 if (ulAttrs & SFGAO_FOLDER)
330 hr = IShellFolder_BindToObject(lpsf,pidlTemp,NULL,&IID_IShellFolder,(LPVOID*)&pSFChild);
333 DWORD flags = BrowseFlagsToSHCONTF(info->lpBrowseInfo->ulFlags);
334 hr = IShellFolder_EnumObjects(pSFChild, hwnd, flags, &pEnumIL);
337 if ((IEnumIDList_Skip(pEnumIL, 1) != S_OK) ||
338 FAILED(IEnumIDList_Reset(pEnumIL)))
340 IEnumIDList_Release(pEnumIL);
344 IShellFolder_Release(pSFChild);
348 if (!(hPrev = InsertTreeViewItem(info, lpsf, pidlTemp, pidl, pEnumIL, hParent)))
350 SHFree(pidlTemp); /* Finally, free the pidl that the shell gave us... */
356 SetCursor(LoadCursorW(0, (LPWSTR)IDC_ARROW));
362 static inline BOOL PIDLIsType(LPCITEMIDLIST pidl, PIDLTYPE type)
364 LPPIDLDATA data = _ILGetDataPointer(pidl);
367 return (data->type == type);
370 static void BrsFolder_CheckValidSelection( browse_info *info, LPTV_ITEMDATA lptvid )
372 LPBROWSEINFOW lpBrowseInfo = info->lpBrowseInfo;
373 LPCITEMIDLIST pidl = lptvid->lpi;
374 BOOL bEnabled = TRUE;
378 if ((lpBrowseInfo->ulFlags & BIF_BROWSEFORCOMPUTER) &&
379 !PIDLIsType(pidl, PT_COMP))
381 if (lpBrowseInfo->ulFlags & BIF_RETURNFSANCESTORS)
383 dwAttributes = SFGAO_FILESYSANCESTOR | SFGAO_FILESYSTEM;
384 r = IShellFolder_GetAttributesOf(lptvid->lpsfParent, 1,
385 (LPCITEMIDLIST*)&lptvid->lpi, &dwAttributes);
386 if (FAILED(r) || !(dwAttributes & (SFGAO_FILESYSANCESTOR|SFGAO_FILESYSTEM)))
389 if (lpBrowseInfo->ulFlags & BIF_RETURNONLYFSDIRS)
391 dwAttributes = SFGAO_FOLDER | SFGAO_FILESYSTEM;
392 r = IShellFolder_GetAttributesOf(lptvid->lpsfParent, 1,
393 (LPCITEMIDLIST*)&lptvid->lpi, &dwAttributes);
395 ((dwAttributes & (SFGAO_FOLDER|SFGAO_FILESYSTEM)) != (SFGAO_FOLDER|SFGAO_FILESYSTEM)))
400 SendMessageW(info->hWnd, BFFM_ENABLEOK, 0, (LPARAM)bEnabled);
403 static LRESULT BrsFolder_Treeview_Delete( browse_info *info, NMTREEVIEWW *pnmtv )
405 LPTV_ITEMDATA lptvid = (LPTV_ITEMDATA)pnmtv->itemOld.lParam;
407 TRACE("TVN_DELETEITEMA/W %p\n", lptvid);
409 IShellFolder_Release(lptvid->lpsfParent);
411 IEnumIDList_Release(lptvid->pEnumIL);
413 SHFree(lptvid->lpifq);
418 static LRESULT BrsFolder_Treeview_Expand( browse_info *info, NMTREEVIEWW *pnmtv )
420 IShellFolder *lpsf2 = NULL;
421 LPTV_ITEMDATA lptvid = (LPTV_ITEMDATA) pnmtv->itemNew.lParam;
424 TRACE("TVN_ITEMEXPANDINGA/W\n");
426 if ((pnmtv->itemNew.state & TVIS_EXPANDEDONCE))
429 if (lptvid->lpi && lptvid->lpi->mkid.cb) {
430 r = IShellFolder_BindToObject( lptvid->lpsfParent, lptvid->lpi, 0,
431 (REFIID)&IID_IShellFolder, (LPVOID *)&lpsf2 );
433 lpsf2 = lptvid->lpsfParent;
434 r = IShellFolder_AddRef(lpsf2);
438 FillTreeView( info, lpsf2, lptvid->lpifq, pnmtv->itemNew.hItem, lptvid->pEnumIL);
440 /* My Computer is already sorted and trying to do a simple text
441 * sort will only mess things up */
442 if (!_ILIsMyComputer(lptvid->lpi))
443 TreeView_SortChildren(info->hwndTreeView, pnmtv->itemNew.hItem, FALSE);
448 static HRESULT BrsFolder_Treeview_Changed( browse_info *info, NMTREEVIEWW *pnmtv )
450 LPTV_ITEMDATA lptvid = (LPTV_ITEMDATA) pnmtv->itemNew.lParam;
452 lptvid = (LPTV_ITEMDATA) pnmtv->itemNew.lParam;
453 info->pidlRet = lptvid->lpifq;
454 browsefolder_callback( info->lpBrowseInfo, info->hWnd, BFFM_SELCHANGED,
455 (LPARAM)info->pidlRet );
456 BrsFolder_CheckValidSelection( info, lptvid );
460 static LRESULT BrsFolder_OnNotify( browse_info *info, UINT CtlID, LPNMHDR lpnmh )
462 NMTREEVIEWW *pnmtv = (NMTREEVIEWW *)lpnmh;
464 TRACE("%p %x %p msg=%x\n", info, CtlID, lpnmh, pnmtv->hdr.code);
466 if (pnmtv->hdr.idFrom != IDD_TREEVIEW)
469 switch (pnmtv->hdr.code)
471 case TVN_DELETEITEMA:
472 case TVN_DELETEITEMW:
473 return BrsFolder_Treeview_Delete( info, pnmtv );
475 case TVN_ITEMEXPANDINGA:
476 case TVN_ITEMEXPANDINGW:
477 return BrsFolder_Treeview_Expand( info, pnmtv );
479 case TVN_SELCHANGEDA:
480 case TVN_SELCHANGEDW:
481 return BrsFolder_Treeview_Changed( info, pnmtv );
484 WARN("unhandled (%d)\n", pnmtv->hdr.code);
492 static BOOL BrsFolder_OnCreate( HWND hWnd, browse_info *info )
494 LPBROWSEINFOW lpBrowseInfo = info->lpBrowseInfo;
497 SetPropW( hWnd, szBrowseFolderInfo, info );
499 if (lpBrowseInfo->ulFlags & ~SUPPORTEDFLAGS)
500 FIXME("flags %x not implemented\n", lpBrowseInfo->ulFlags & ~SUPPORTEDFLAGS);
502 if (lpBrowseInfo->lpszTitle)
503 SetWindowTextW( GetDlgItem(hWnd, IDD_TITLE), lpBrowseInfo->lpszTitle );
505 ShowWindow( GetDlgItem(hWnd, IDD_TITLE), SW_HIDE );
507 if (!(lpBrowseInfo->ulFlags & BIF_STATUSTEXT))
508 ShowWindow( GetDlgItem(hWnd, IDD_STATUS), SW_HIDE );
510 info->hwndTreeView = GetDlgItem( hWnd, IDD_TREEVIEW );
511 if (info->hwndTreeView)
512 InitializeTreeView( info );
514 ERR("treeview control missing!\n");
516 browsefolder_callback( info->lpBrowseInfo, hWnd, BFFM_INITIALIZED, 0 );
521 static BOOL BrsFolder_OnCommand( browse_info *info, UINT id )
523 LPBROWSEINFOW lpBrowseInfo = info->lpBrowseInfo;
528 info->pidlRet = ILClone(info->pidlRet); /* The original pidl will be free'd. */
529 pdump( info->pidlRet );
530 if (lpBrowseInfo->pszDisplayName)
531 SHGetPathFromIDListW( info->pidlRet, lpBrowseInfo->pszDisplayName );
532 EndDialog( info->hWnd, 1 );
536 EndDialog( info->hWnd, 0 );
542 /*************************************************************************
543 * BrsFolderDlgProc32 (not an exported API function)
545 static INT_PTR CALLBACK BrsFolderDlgProc( HWND hWnd, UINT msg, WPARAM wParam,
550 TRACE("hwnd=%p msg=%04x 0x%08x 0x%08lx\n", hWnd, msg, wParam, lParam );
552 if (msg == WM_INITDIALOG)
553 return BrsFolder_OnCreate( hWnd, (browse_info*) lParam );
555 info = (browse_info*) GetPropW( hWnd, szBrowseFolderInfo );
560 return BrsFolder_OnNotify( info, (UINT)wParam, (LPNMHDR)lParam);
563 return BrsFolder_OnCommand( info, wParam );
565 case BFFM_SETSTATUSTEXTA:
566 TRACE("Set status %s\n", debugstr_a((LPSTR)lParam));
567 SetWindowTextA(GetDlgItem(hWnd, IDD_STATUS), (LPSTR)lParam);
570 case BFFM_SETSTATUSTEXTW:
571 TRACE("Set status %s\n", debugstr_w((LPWSTR)lParam));
572 SetWindowTextW(GetDlgItem(hWnd, IDD_STATUS), (LPWSTR)lParam);
576 TRACE("Enable %ld\n", lParam);
577 EnableWindow(GetDlgItem(hWnd, 1), (lParam)?TRUE:FALSE);
580 case BFFM_SETOKTEXT: /* unicode only */
581 TRACE("Set OK text %s\n", debugstr_w((LPWSTR)wParam));
582 SetWindowTextW(GetDlgItem(hWnd, 1), (LPWSTR)wParam);
585 case BFFM_SETSELECTIONA:
587 FIXME("Set selection %s\n", debugstr_a((LPSTR)lParam));
589 FIXME("Set selection %p\n", (void*)lParam);
592 case BFFM_SETSELECTIONW:
594 FIXME("Set selection %s\n", debugstr_w((LPWSTR)lParam));
596 FIXME("Set selection %p\n", (void*)lParam);
599 case BFFM_SETEXPANDED: /* unicode only */
601 FIXME("Set expanded %s\n", debugstr_w((LPWSTR)lParam));
603 FIXME("Set expanded %p\n", (void*)lParam);
609 static const WCHAR swBrowseTemplateName[] = {
610 'S','H','B','R','S','F','O','R','F','O','L','D','E','R','_','M','S','G','B','O','X',0};
612 /*************************************************************************
613 * SHBrowseForFolderA [SHELL32.@]
614 * SHBrowseForFolder [SHELL32.@]
616 LPITEMIDLIST WINAPI SHBrowseForFolderA (LPBROWSEINFOA lpbi)
624 bi.hwndOwner = lpbi->hwndOwner;
625 bi.pidlRoot = lpbi->pidlRoot;
626 if (lpbi->pszDisplayName)
628 bi.pszDisplayName = HeapAlloc( GetProcessHeap(), 0, MAX_PATH * sizeof(WCHAR) );
629 MultiByteToWideChar( CP_ACP, 0, lpbi->pszDisplayName, -1, bi.pszDisplayName, MAX_PATH );
632 bi.pszDisplayName = NULL;
636 len = MultiByteToWideChar( CP_ACP, 0, lpbi->lpszTitle, -1, NULL, 0 );
637 bi.lpszTitle = HeapAlloc( GetProcessHeap(), 0, len * sizeof(WCHAR) );
638 MultiByteToWideChar( CP_ACP, 0, lpbi->lpszTitle, -1, (LPWSTR)bi.lpszTitle, len );
643 bi.ulFlags = lpbi->ulFlags;
644 bi.lpfn = lpbi->lpfn;
645 bi.lParam = lpbi->lParam;
646 bi.iImage = lpbi->iImage;
647 lpid = SHBrowseForFolderW( &bi );
648 if (bi.pszDisplayName)
650 WideCharToMultiByte( CP_ACP, 0, bi.pszDisplayName, -1,
651 lpbi->pszDisplayName, MAX_PATH, 0, NULL);
652 HeapFree( GetProcessHeap(), 0, bi.pszDisplayName );
654 HeapFree(GetProcessHeap(), 0, (LPVOID)bi.lpszTitle);
655 lpbi->iImage = bi.iImage;
660 /*************************************************************************
661 * SHBrowseForFolderW [SHELL32.@]
664 * crashes when passed a null pointer
666 LPITEMIDLIST WINAPI SHBrowseForFolderW (LPBROWSEINFOW lpbi)
674 info.lpBrowseInfo = lpbi;
675 info.hwndTreeView = NULL;
677 hr = OleInitialize(NULL);
678 r = DialogBoxParamW( shell32_hInstance, swBrowseTemplateName, lpbi->hwndOwner,
679 BrsFolderDlgProc, (LPARAM)&info );