2 * Copyright (C) the Wine project
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
19 #ifndef __WINE_SHLOBJ_H
20 #define __WINE_SHLOBJ_H
23 #include "winbase.h" /* WIN32_FIND_* */
30 #endif /* defined(__cplusplus) */
32 /****************************************************************************
33 * SHITEMID, ITEMIDLIST, PIDL API
38 WORD cb; /* nr of bytes in this item */
39 BYTE abID[1]; /* first byte in this item */
40 } SHITEMID, *LPSHITEMID;
41 typedef LPSHITEMID const LPCSHITEMID;
43 typedef struct _ITEMIDLIST
45 SHITEMID mkid; /* first itemid in list */
46 } ITEMIDLIST,*LPITEMIDLIST,*LPCITEMIDLIST;
49 BOOL WINAPI SHGetPathFromIDListA (LPCITEMIDLIST pidl,LPSTR pszPath);
50 BOOL WINAPI SHGetPathFromIDListW (LPCITEMIDLIST pidl,LPWSTR pszPath);
51 #define SHGetPathFromIDList WINELIB_NAME_AW(SHGetPathFromIDList)
54 #include "wine/obj_base.h"
55 #include "wine/obj_enumidlist.h"
56 #include "wine/obj_inplace.h"
57 #include "wine/obj_oleaut.h"
58 #include "wine/obj_shellfolder.h"
59 #include "wine/obj_shellview.h"
60 #include "wine/obj_shelllink.h"
61 #include "wine/obj_shellbrowser.h"
62 #include "wine/obj_contextmenu.h"
63 #include "wine/obj_shellextinit.h"
64 #include "wine/obj_extracticon.h"
65 #include "wine/obj_commdlgbrowser.h"
66 #include "wine/obj_dockingwindowframe.h"
68 /*****************************************************************************
69 * Predeclare interfaces
71 typedef struct IShellIcon IShellIcon, *LPSHELLICON;
74 /*****************************************************************************
75 * IContextMenu interface
79 /* DATAOBJECT_InitShellIDList*/
80 #define CFSTR_SHELLIDLIST "Shell IDList Array" /* CF_IDLIST */
82 extern UINT cfShellIDList;
87 } CIDA, *LPCIDA,*LPIDA;
89 #define CFSTR_SHELLIDLISTOFFSET "Shell Object Offsets" /* CF_OBJECTPOSITIONS */
90 #define CFSTR_NETRESOURCES "Net Resource" /* CF_NETRESOURCE */
92 /* DATAOBJECT_InitFileGroupDesc */
93 #define CFSTR_FILEDESCRIPTORA "FileGroupDescriptor" /* CF_FILEGROUPDESCRIPTORA */
94 extern UINT cfFileGroupDesc;
96 #define CFSTR_FILEDESCRIPTORW "FileGroupDescriptorW" /* CF_FILEGROUPDESCRIPTORW */
98 /* DATAOBJECT_InitFileContents*/
99 #define CFSTR_FILECONTENTS "FileContents" /* CF_FILECONTENTS */
100 extern UINT cfFileContents;
102 #define CFSTR_FILENAMEA "FileName" /* CF_FILENAMEA */
103 #define CFSTR_FILENAMEW "FileNameW" /* CF_FILENAMEW */
104 #define CFSTR_PRINTERGROUP "PrinterFriendlyName" /* CF_PRINTERS */
105 #define CFSTR_FILENAMEMAPA "FileNameMap" /* CF_FILENAMEMAPA */
106 #define CFSTR_FILENAMEMAPW "FileNameMapW" /* CF_FILENAMEMAPW */
107 #define CFSTR_SHELLURL "UniformResourceLocator"
108 #define CFSTR_PREFERREDDROPEFFECT "Preferred DropEffect"
109 #define CFSTR_PERFORMEDDROPEFFECT "Performed DropEffect"
110 #define CFSTR_PASTESUCCEEDED "Paste Succeeded"
111 #define CFSTR_INDRAGLOOP "InShellDragLoop"
114 /************************************************************************
115 * IShellView interface
118 typedef GUID SHELLVIEWID;
119 #define SV_CLASS_NAME ("SHELLDLL_DefView")
121 /****************************************************************************
122 * IShellIcon interface
125 #define ICOM_INTERFACE IShellIcon
126 #define IShellIcon_METHODS \
127 ICOM_METHOD3(HRESULT, GetIconOf, LPCITEMIDLIST,pidl, UINT,flags, LPINT,lpIconIndex)
128 #define IShellIcon_IMETHODS \
131 ICOM_DEFINE(IShellIcon, IUnknown)
132 #undef ICOM_INTERFACE
134 /*** IUnknown methods ***/
135 #define IShellIcon_QueryInterface(p,a,b) ICOM_CALL2(QueryInterface,p,a,b)
136 #define IShellIcon_AddRef(p) ICOM_CALL (AddRef,p)
137 #define IShellIcon_Release(p) ICOM_CALL (Release,p)
138 /*** IShellIcon methods ***/
139 #define IShellIcon_GetIconOf(p,a,b,c) ICOM_CALL3(GetIconOf,p,a,b,c)
141 /****************************************************************************
142 * SHAddToRecentDocs API
144 #define SHARD_PIDL 0x00000001L
145 #define SHARD_PATHA 0x00000002L
146 #define SHARD_PATHW 0x00000003L
147 #define SHARD_PATH WINELIB_NAME_AW(SHARD_PATH)
149 DWORD WINAPI SHAddToRecentDocs(UINT uFlags, LPCVOID pv);
151 /****************************************************************************
154 #define SE_ERR_FNF 2 /* file not found */
155 #define SE_ERR_PNF 3 /* path not found */
156 #define SE_ERR_ACCESSDENIED 5 /* access denied */
157 #define SE_ERR_OOM 8 /* out of memory */
158 #define SE_ERR_DLLNOTFOUND 32
159 #define SE_ERR_SHARE 26
160 #define SE_ERR_ASSOCINCOMPLETE 27
161 #define SE_ERR_DDETIMEOUT 28
162 #define SE_ERR_DDEFAIL 29
163 #define SE_ERR_DDEBUSY 30
164 #define SE_ERR_NOASSOC 31
166 #define SEE_MASK_CLASSNAME 0x00000001
167 #define SEE_MASK_CLASSKEY 0x00000003
168 #define SEE_MASK_IDLIST 0x00000004
169 #define SEE_MASK_INVOKEIDLIST 0x0000000c
170 #define SEE_MASK_ICON 0x00000010
171 #define SEE_MASK_HOTKEY 0x00000020
172 #define SEE_MASK_NOCLOSEPROCESS 0x00000040
173 #define SEE_MASK_CONNECTNETDRV 0x00000080
174 #define SEE_MASK_FLAG_DDEWAIT 0x00000100
175 #define SEE_MASK_DOENVSUBST 0x00000200
176 #define SEE_MASK_FLAG_NO_UI 0x00000400
177 #define SEE_MASK_UNICODE 0x00004000
178 #define SEE_MASK_NO_CONSOLE 0x00008000
179 #define SEE_MASK_ASYNCOK 0x00100000
180 #define SEE_MASK_HMONITOR 0x00200000
182 typedef struct _SHELLEXECUTEINFOA
192 /* Optional fields */
202 } SHELLEXECUTEINFOA, *LPSHELLEXECUTEINFOA;
204 typedef struct _SHELLEXECUTEINFOW
210 LPCWSTR lpParameters;
224 } SHELLEXECUTEINFOW, *LPSHELLEXECUTEINFOW;
226 #define SHELLEXECUTEINFO WINELIB_NAME_AW(SHELLEXECUTEINFO)
227 #define LPSHELLEXECUTEINFO WINELIB_NAME_AW(LPSHELLEXECUTEINFO)
229 BOOL WINAPI ShellExecuteExA(LPSHELLEXECUTEINFOA lpExecInfo);
230 BOOL WINAPI ShellExecuteExW(LPSHELLEXECUTEINFOW lpExecInfo);
231 #define ShellExecuteEx WINELIB_NAME_AW(ShellExecuteEx)
233 void WINAPI WinExecErrorA(HWND hwnd,INT error, LPCSTR lpstrFileName, LPCSTR lpstrTitle);
234 void WINAPI WinExecErrorW(HWND hwnd,INT error, LPCWSTR lpstrFileName, LPCWSTR lpstrTitle);
235 #define WinExecError WINELIB_NAME_AW(WinExecError)
239 /****************************************************************************
240 * SHBrowseForFolder API
242 typedef INT (CALLBACK *BFFCALLBACK)(HWND hwnd, UINT uMsg, LPARAM lParam, LPARAM lpData);
244 typedef struct tagBROWSEINFOA {
246 LPCITEMIDLIST pidlRoot;
247 LPSTR pszDisplayName;
253 } BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;
255 typedef struct tagBROWSEINFOW {
257 LPCITEMIDLIST pidlRoot;
258 LPWSTR pszDisplayName;
264 } BROWSEINFOW, *PBROWSEINFOW, *LPBROWSEINFOW;
266 #define BROWSEINFO WINELIB_NAME_AW(BROWSEINFO)
267 #define PBROWSEINFO WINELIB_NAME_AW(PBROWSEINFO)
268 #define LPBROWSEINFO WINELIB_NAME_AW(LPBROWSEINFO)
270 /* Browsing for directory. */
271 #define BIF_RETURNONLYFSDIRS 0x0001
272 #define BIF_DONTGOBELOWDOMAIN 0x0002
273 #define BIF_STATUSTEXT 0x0004
274 #define BIF_RETURNFSANCESTORS 0x0008
275 #define BIF_EDITBOX 0x0010
276 #define BIF_VALIDATE 0x0020
278 #define BIF_BROWSEFORCOMPUTER 0x1000
279 #define BIF_BROWSEFORPRINTER 0x2000
280 #define BIF_BROWSEINCLUDEFILES 0x4000
282 /* message from browser */
283 #define BFFM_INITIALIZED 1
284 #define BFFM_SELCHANGED 2
285 #define BFFM_VALIDATEFAILEDA 3 /* lParam:szPath ret:1(cont),0(EndDialog) */
286 #define BFFM_VALIDATEFAILEDW 4 /* lParam:wzPath ret:1(cont),0(EndDialog) */
288 /* messages to browser */
289 #define BFFM_SETSTATUSTEXTA (WM_USER+100)
290 #define BFFM_ENABLEOK (WM_USER+101)
291 #define BFFM_SETSELECTIONA (WM_USER+102)
292 #define BFFM_SETSELECTIONW (WM_USER+103)
293 #define BFFM_SETSTATUSTEXTW (WM_USER+104)
295 LPITEMIDLIST WINAPI SHBrowseForFolderA(LPBROWSEINFOA lpbi);
296 LPITEMIDLIST WINAPI SHBrowseForFolderW(LPBROWSEINFOW lpbi);
297 #define SHBrowseForFolder WINELIB_NAME_AW(SHBrowseForFolder)
298 #define BFFM_SETSTATUSTEXT WINELIB_NAME_AW(BFFM_SETSTATUSTEXT)
299 #define BFFM_SETSELECTION WINELIB_NAME_AW(BFFM_SETSELECTION)
300 #define BFFM_VALIDATEFAILED WINELIB_NAME_AW(BFFM_VALIDATEFAILED)
302 /****************************************************************************
303 * SHGetDataFromIDList API
305 #define SHGDFIL_FINDDATA 1
306 #define SHGDFIL_NETRESOURCE 2
307 #define SHGDFIL_DESCRIPTIONID 3
309 #define SHDID_ROOT_REGITEM 1
310 #define SHDID_FS_FILE 2
311 #define SHDID_FS_DIRECTORY 3
312 #define SHDID_FS_OTHER 4
313 #define SHDID_COMPUTER_DRIVE35 5
314 #define SHDID_COMPUTER_DRIVE525 6
315 #define SHDID_COMPUTER_REMOVABLE 7
316 #define SHDID_COMPUTER_FIXED 8
317 #define SHDID_COMPUTER_NETDRIVE 9
318 #define SHDID_COMPUTER_CDROM 10
319 #define SHDID_COMPUTER_RAMDISK 11
320 #define SHDID_COMPUTER_OTHER 12
321 #define SHDID_NET_DOMAIN 13
322 #define SHDID_NET_SERVER 14
323 #define SHDID_NET_SHARE 15
324 #define SHDID_NET_RESTOFNET 16
325 #define SHDID_NET_OTHER 17
327 typedef struct _SHDESCRIPTIONID
328 { DWORD dwDescriptionId;
330 } SHDESCRIPTIONID, *LPSHDESCRIPTIONID;
332 HRESULT WINAPI SHGetDataFromIDListA(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID pv, int cb);
333 HRESULT WINAPI SHGetDataFromIDListW(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID pv, int cb);
334 #define SHGetDataFromIDList WINELIB_NAME_AW(SHGetDataFromIDList)
336 BOOL WINAPI SHGetSpecialFolderPathA (HWND hwndOwner,LPSTR szPath,DWORD csidl,BOOL bCreate);
337 BOOL WINAPI SHGetSpecialFolderPathW (HWND hwndOwner,LPWSTR szPath,DWORD csidl,BOOL bCreate);
338 #define SHGetSpecialFolderPath WINELIB_NAME_AW(SHGetSpecialFolderPath)
340 HRESULT WINAPI SHGetSpecialFolderLocation(HWND hwndOwner, INT nFolder, LPITEMIDLIST * ppidl);
342 /****************************************************************************
347 * IShellFolderViewCallback Callback
348 * This "callback" is called by the shells default IShellView implementation (that
349 * we got using SHCreateShellViewEx()), to notify us of the various things that
350 * are happening to the shellview (and ask for things too).
352 * You don't have to support anything here - anything you don't want to
353 * handle, the shell will do itself if you just return E_NOTIMPL. This parameters
354 * that the shell passes to this function are entirely undocumented.
356 * HOWEVER, as the cabview sample as originally written used this callback, the
357 * writers implemented the callback mechanism on top of their own IShellView.
358 * Look there for some clues on what to do here.
361 typedef HRESULT (CALLBACK *SHELLVIEWPROC)(DWORD dwUserParam,LPSHELLFOLDER psf,
362 HWND hwnd,UINT uMsg,UINT wParam,LPARAM lParam);
364 /* NF valid values for the "viewmode" item of the SHELLTEMPLATE*/
365 #define NF_INHERITVIEW 0x0000
366 #define NF_LOCALVIEW 0x0001
368 typedef struct _SHELLVIEWDATA /* idl */
370 LPSHELLFOLDER pShellFolder;
373 DWORD v3; /* always 0 */
374 SHELLVIEWPROC pCallBack;
375 DWORD viewmode; /* NF_* enum */
376 } SHELLVIEWDATA, * LPSHELLVIEWDATA;
378 DWORD WINAPI SHGetMalloc(LPMALLOC *lpmal) ;
380 /**********************************************************************
384 { BOOL fShowAllObjects : 1;
385 BOOL fShowExtensions : 1;
386 BOOL fNoConfirmRecycle : 1;
387 BOOL fShowSysFiles : 1;
389 BOOL fShowCompColor : 1;
390 BOOL fDoubleClickInWebView : 1;
391 BOOL fDesktopHTML : 1;
392 BOOL fWin95Classic : 1;
394 BOOL fDontPrettyPath : 1;
395 BOOL fShowAttribCol : 1;
396 BOOL fMapNetDrvBtn : 1;
397 BOOL fShowInfoTip : 1;
401 } SHELLFLAGSTATE, * LPSHELLFLAGSTATE;
403 VOID WINAPI SHGetSettings(LPSHELLFLAGSTATE lpsfs, DWORD dwMask);
405 #define SSF_SHOWALLOBJECTS 0x0001
406 #define SSF_SHOWEXTENSIONS 0x0002
407 #define SSF_SHOWCOMPCOLOR 0x0008
408 #define SSF_SHOWSYSFILES 0x0020
409 #define SSF_DOUBLECLICKINWEBVIEW 0x0080
410 #define SSF_SHOWATTRIBCOL 0x0100
411 #define SSF_DESKTOPHTML 0x0200
412 #define SSF_WIN95CLASSIC 0x0400
413 #define SSF_DONTPRETTYPATH 0x0800
414 #define SSF_SHOWINFOTIP 0x2000
415 #define SSF_MAPNETDRVBUTTON 0x1000
416 #define SSF_NOCONFIRMRECYCLE 0x8000
417 #define SSF_HIDEICONS 0x4000
419 /**********************************************************************
422 #define SHCNE_RENAMEITEM 0x00000001
423 #define SHCNE_CREATE 0x00000002
424 #define SHCNE_DELETE 0x00000004
425 #define SHCNE_MKDIR 0x00000008
426 #define SHCNE_RMDIR 0x00000010
427 #define SHCNE_MEDIAINSERTED 0x00000020
428 #define SHCNE_MEDIAREMOVED 0x00000040
429 #define SHCNE_DRIVEREMOVED 0x00000080
430 #define SHCNE_DRIVEADD 0x00000100
431 #define SHCNE_NETSHARE 0x00000200
432 #define SHCNE_NETUNSHARE 0x00000400
433 #define SHCNE_ATTRIBUTES 0x00000800
434 #define SHCNE_UPDATEDIR 0x00001000
435 #define SHCNE_UPDATEITEM 0x00002000
436 #define SHCNE_SERVERDISCONNECT 0x00004000
437 #define SHCNE_UPDATEIMAGE 0x00008000
438 #define SHCNE_DRIVEADDGUI 0x00010000
439 #define SHCNE_RENAMEFOLDER 0x00020000
440 #define SHCNE_FREESPACE 0x00040000
442 #define SHCNE_EXTENDED_EVENT 0x04000000
443 #define SHCNE_ASSOCCHANGED 0x08000000
444 #define SHCNE_DISKEVENTS 0x0002381F
445 #define SHCNE_GLOBALEVENTS 0x0C0581E0
446 #define SHCNE_ALLEVENTS 0x7FFFFFFF
447 #define SHCNE_INTERRUPT 0x80000000
449 #define SHCNEE_ORDERCHANGED 0x00000002
451 #define SHCNF_IDLIST 0x0000
452 #define SHCNF_PATHA 0x0001
453 #define SHCNF_PRINTERA 0x0002
454 #define SHCNF_DWORD 0x0003
455 #define SHCNF_PATHW 0x0005
456 #define SHCNF_PRINTERW 0x0006
457 #define SHCNF_TYPE 0x00FF
458 #define SHCNF_FLUSH 0x1000
459 #define SHCNF_FLUSHNOWAIT 0x2000
461 void WINAPI SHChangeNotifyA(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2);
462 void WINAPI SHChangeNotifyW(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2);
463 #define SHChangeNotify WINELIB_NAME_AW(SHChangeNotify)
465 /****************************************************************************
466 * SHGetSpecialFolderLocation API
468 HRESULT WINAPI SHGetSpecialFolderLocation(HWND, INT, LPITEMIDLIST *);
470 #define CSIDL_DESKTOP 0x0000
471 #define CSIDL_INTERNET 0x0001
472 #define CSIDL_PROGRAMS 0x0002
473 #define CSIDL_CONTROLS 0x0003
474 #define CSIDL_PRINTERS 0x0004
475 #define CSIDL_PERSONAL 0x0005
476 #define CSIDL_FAVORITES 0x0006
477 #define CSIDL_STARTUP 0x0007
478 #define CSIDL_RECENT 0x0008
479 #define CSIDL_SENDTO 0x0009
480 #define CSIDL_BITBUCKET 0x000a
481 #define CSIDL_STARTMENU 0x000b
482 #define CSIDL_MYDOCUMENTS 0x000c
483 #define CSIDL_MYMUSIC 0x000d
484 #define CSIDL_MYVIDEO 0x000e
485 #define CSIDL_DESKTOPDIRECTORY 0x0010
486 #define CSIDL_DRIVES 0x0011
487 #define CSIDL_NETWORK 0x0012
488 #define CSIDL_NETHOOD 0x0013
489 #define CSIDL_FONTS 0x0014
490 #define CSIDL_TEMPLATES 0x0015
491 #define CSIDL_COMMON_STARTMENU 0x0016
492 #define CSIDL_COMMON_PROGRAMS 0X0017
493 #define CSIDL_COMMON_STARTUP 0x0018
494 #define CSIDL_COMMON_DESKTOPDIRECTORY 0x0019
495 #define CSIDL_APPDATA 0x001a
496 #define CSIDL_PRINTHOOD 0x001b
497 #define CSIDL_LOCAL_APPDATA 0x001c
498 #define CSIDL_ALTSTARTUP 0x001d
499 #define CSIDL_COMMON_ALTSTARTUP 0x001e
500 #define CSIDL_COMMON_FAVORITES 0x001f
501 #define CSIDL_INTERNET_CACHE 0x0020
502 #define CSIDL_COOKIES 0x0021
503 #define CSIDL_HISTORY 0x0022
504 #define CSIDL_COMMON_APPDATA 0x0023
505 #define CSIDL_WINDOWS 0x0024
506 #define CSIDL_SYSTEM 0x0025
507 #define CSIDL_PROGRAM_FILES 0x0026
508 #define CSIDL_MYPICTURES 0x0027
509 #define CSIDL_PROFILE 0x0028
510 #define CSIDL_SYSTEMX86 0x0029
511 #define CSIDL_PROGRAM_FILESX86 0x002a
512 #define CSIDL_PROGRAM_FILES_COMMON 0x002b
513 #define CSIDL_PROGRAM_FILES_COMMONX86 0x002c
514 #define CSIDL_COMMON_TEMPLATES 0x002d
515 #define CSIDL_COMMON_DOCUMENTS 0x002e
516 #define CSIDL_COMMON_ADMINTOOLS 0x002f
517 #define CSIDL_ADMINTOOLS 0x0030
518 #define CSIDL_CONNECTIONS 0x0031
519 #define CSIDL_COMMON_MUSIC 0x0035
520 #define CSIDL_COMMON_PICTURES 0x0036
521 #define CSIDL_COMMON_VIDEO 0x0037
522 #define CSIDL_RESOURCES 0x0038
523 #define CSIDL_RESOURCES_LOCALIZED 0x0039
524 #define CSIDL_COMMON_OEM_LINKS 0x003a
525 #define CSIDL_CDBURN_AREA 0x003b
526 #define CSIDL_COMPUTERSNEARME 0x003d
527 #define CSIDL_FOLDER_MASK 0x00ff
528 #define CSIDL_FLAG_PER_USER_INIT 0x0800
529 #define CSIDL_FLAG_NO_ALIAS 0x1000
530 #define CSIDL_FLAG_DONT_VERIFY 0x4000
531 #define CSIDL_FLAG_CREATE 0x8000
533 #define CSIDL_FLAG_MASK 0xff00
536 * DROPFILES for CF_HDROP and CF_PRINTERS
538 typedef struct _DROPFILES
548 #endif /* defined(__cplusplus) */
550 #endif /* __WINE_SHLOBJ_H */