include/shlobj.h

   1 #ifndef __WINE_SHLOBJ_H
   2 #define __WINE_SHLOBJ_H
   3
   4 #include "wine/obj_base.h"
   5 #include "wine/obj_shelllink.h"
   6 #include "wine/obj_shellfolder.h"
   7 #include "wine/obj_shellbrowser.h"
   8 #include "wine/obj_contextmenu.h"
   9 #include "wine/obj_shellextinit.h"
  10 #include "wine/obj_extracticon.h"
  11 #include "wine/obj_commdlgbrowser.h"
  12 #include "wine/obj_dockingwindowframe.h"
  13
  14 #include "windef.h"
  15 #include "winbase.h"    /* WIN32_FIND_* */
  16 #include "ole2.h"
  17 #include "shell.h"
  18 #include "commctrl.h"
  19 #include "prsht.h"
  20
  21 #ifdef __cplusplus
  22 extern "C" {
  23 #endif /* defined(__cplusplus) */
  24
  25 /*****************************************************************************
  26  * Predeclare interfaces
  27  */
  28 typedef struct IShellIcon IShellIcon, *LPSHELLICON;
  29
  30
  31 /*****************************************************************************
  32  * IContextMenu interface
  33  */
  34
  35
  36 /* DATAOBJECT_InitShellIDList*/
  37 #define CFSTR_SHELLIDLIST       "Shell IDList Array"      /* CF_IDLIST */
  38
  39 extern UINT cfShellIDList;
  40
  41 typedef struct
  42 {       UINT cidl;
  43         UINT aoffset[1];
  44 } CIDA, *LPCIDA,*LPIDA;
  45
  46 #define CFSTR_SHELLIDLISTOFFSET "Shell Object Offsets"    /* CF_OBJECTPOSITIONS */
  47 #define CFSTR_NETRESOURCES      "Net Resource"            /* CF_NETRESOURCE */
  48
  49 /* DATAOBJECT_InitFileGroupDesc */
  50 #define CFSTR_FILEDESCRIPTORA   "FileGroupDescriptor"     /* CF_FILEGROUPDESCRIPTORA */
  51 extern UINT cfFileGroupDesc;
  52
  53 #define CFSTR_FILEDESCRIPTORW   "FileGroupDescriptorW"    /* CF_FILEGROUPDESCRIPTORW */
  54
  55 /* DATAOBJECT_InitFileContents*/
  56 #define CFSTR_FILECONTENTS      "FileContents"            /* CF_FILECONTENTS */
  57 extern UINT cfFileContents;
  58
  59 #define CFSTR_FILENAMEA         "FileName"                /* CF_FILENAMEA */
  60 #define CFSTR_FILENAMEW         "FileNameW"               /* CF_FILENAMEW */
  61 #define CFSTR_PRINTERGROUP      "PrinterFriendlyName"     /* CF_PRINTERS */
  62 #define CFSTR_FILENAMEMAPA      "FileNameMap"             /* CF_FILENAMEMAPA */
  63 #define CFSTR_FILENAMEMAPW      "FileNameMapW"            /* CF_FILENAMEMAPW */
  64 #define CFSTR_SHELLURL          "UniformResourceLocator"
  65 #define CFSTR_PREFERREDDROPEFFECT "Preferred DropEffect"
  66 #define CFSTR_PERFORMEDDROPEFFECT "Performed DropEffect"
  67 #define CFSTR_PASTESUCCEEDED    "Paste Succeeded"
  68 #define CFSTR_INDRAGLOOP        "InShellDragLoop"
  69
  70
  71 /************************************************************************
  72 * IShellView interface
  73 */
  74
  75 typedef GUID SHELLVIEWID;
  76 #define SV_CLASS_NAME   ("SHELLDLL_DefView")
  77
  78 /****************************************************************************
  79  * IShellIcon interface
  80  */
  81
  82 #define ICOM_INTERFACE IShellIcon
  83 #define IShellIcon_METHODS \
  84     ICOM_METHOD3(HRESULT, GetIconOf,     LPCITEMIDLIST,pidl, UINT,flags, LPINT,lpIconIndex)
  85 #define IShellIcon_IMETHODS \
  86     IUnknown_IMETHODS \
  87     IShellIcon_METHODS
  88 ICOM_DEFINE(IShellIcon, IUnknown)
  89 #undef ICOM_INTERFACE
  90
  91 /*** IUnknown methods ***/
  92 #define IShellIcon_QueryInterface(p,a,b)      ICOM_CALL2(QueryInterface,p,a,b)
  93 #define IShellIcon_AddRef(p)                  ICOM_CALL (AddRef,p)
  94 #define IShellIcon_Release(p)                 ICOM_CALL (Release,p)
  95 /*** IShellIcon methods ***/
  96 #define IShellIcon_GetIconOf(p,a,b,c)         ICOM_CALL3(GetIconOf,p,a,b,c)
  97
  98 /****************************************************************************
  99  * Shell Execute API
 100  */
 101 #define SE_ERR_FNF              2       /* file not found */
 102 #define SE_ERR_PNF              3       /* path not found */
 103 #define SE_ERR_ACCESSDENIED     5       /* access denied */
 104 #define SE_ERR_OOM              8       /* out of memory */
 105 #define SE_ERR_DLLNOTFOUND      32
 106 #define SE_ERR_SHARE                    26
 107 #define SE_ERR_ASSOCINCOMPLETE          27
 108 #define SE_ERR_DDETIMEOUT               28
 109 #define SE_ERR_DDEFAIL                  29
 110 #define SE_ERR_DDEBUSY                  30
 111 #define SE_ERR_NOASSOC                  31
 112
 113 #define SEE_MASK_CLASSNAME        0x00000001
 114 #define SEE_MASK_CLASSKEY         0x00000003
 115 #define SEE_MASK_IDLIST           0x00000004
 116 #define SEE_MASK_INVOKEIDLIST     0x0000000c
 117 #define SEE_MASK_ICON             0x00000010
 118 #define SEE_MASK_HOTKEY           0x00000020
 119 #define SEE_MASK_NOCLOSEPROCESS   0x00000040
 120 #define SEE_MASK_CONNECTNETDRV    0x00000080
 121 #define SEE_MASK_FLAG_DDEWAIT     0x00000100
 122 #define SEE_MASK_DOENVSUBST       0x00000200
 123 #define SEE_MASK_FLAG_NO_UI       0x00000400
 124 #define SEE_MASK_UNICODE          0x00004000
 125 #define SEE_MASK_NO_CONSOLE       0x00008000
 126 #define SEE_MASK_ASYNCOK          0x00100000
 127 #define SEE_MASK_HMONITOR         0x00200000
 128
 129 typedef struct _SHELLEXECUTEINFOA
 130 {       DWORD cbSize;
 131         ULONG fMask;
 132         HWND hwnd;
 133         LPCSTR   lpVerb;
 134         LPCSTR   lpFile;
 135         LPCSTR   lpParameters;
 136         LPCSTR   lpDirectory;
 137        INT nShow;
 138         HINSTANCE hInstApp;
 139         /* Optional fields */
 140         LPVOID lpIDList;
 141         LPCSTR   lpClass;
 142         HKEY hkeyClass;
 143         DWORD dwHotKey;
 144         union
 145         { HANDLE hIcon;
 146           HANDLE hMonitor;
 147         } DUMMYUNIONNAME;
 148         HANDLE hProcess;
 149 } SHELLEXECUTEINFOA, *LPSHELLEXECUTEINFOA;
 150
 151 typedef struct _SHELLEXECUTEINFOW
 152 {       DWORD cbSize;
 153         ULONG fMask;
 154         HWND hwnd;
 155         LPCWSTR  lpVerb;
 156         LPCWSTR  lpFile;
 157         LPCWSTR  lpParameters;
 158         LPCWSTR  lpDirectory;
 159        INT nShow;
 160         HINSTANCE hInstApp;
 161         /* Optional fields*/
 162         LPVOID lpIDList;
 163         LPCWSTR  lpClass;
 164         HKEY hkeyClass;
 165         DWORD dwHotKey;
 166         union
 167         { HANDLE hIcon;
 168           HANDLE hMonitor;
 169         } DUMMYUNIONNAME;
 170         HANDLE hProcess;
 171 } SHELLEXECUTEINFOW, *LPSHELLEXECUTEINFOW;
 172
 173 #define SHELLEXECUTEINFO   WINELIB_NAME_AW(SHELLEXECUTEINFO)
 174 #define LPSHELLEXECUTEINFO WINELIB_NAME_AW(LPSHELLEXECUTEINFO)
 175
 176 BOOL WINAPI ShellExecuteExA(LPSHELLEXECUTEINFOA lpExecInfo);
 177 BOOL WINAPI ShellExecuteExW(LPSHELLEXECUTEINFOW lpExecInfo);
 178 #define ShellExecuteEx  WINELIB_NAME_AW(ShellExecuteEx)
 179
 180 void WINAPI WinExecErrorA(HWND hwnd,INT error, LPCSTR lpstrFileName, LPCSTR lpstrTitle);
 181 void WINAPI WinExecErrorW(HWND hwnd,INT error, LPCWSTR lpstrFileName, LPCWSTR lpstrTitle);
 182 #define WinExecError  WINELIB_NAME_AW(WinExecError)
 183
 184
 185
 186 /****************************************************************************
 187  * SHBrowseForFolder API
 188  */
 189 typedef INT (CALLBACK* BFFCALLBACK)(HWND hwnd, UINT uMsg, LPARAM lParam, LPARAM lpData);
 190
 191 typedef struct tagBROWSEINFOA {
 192     HWND        hwndOwner;
 193     LPCITEMIDLIST pidlRoot;
 194     LPSTR         pszDisplayName;
 195     LPCSTR        lpszTitle;
 196     UINT        ulFlags;
 197     BFFCALLBACK   lpfn;
 198     LPARAM        lParam;
 199     INT         iImage;
 200 } BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;
 201
 202 typedef struct tagBROWSEINFOW {
 203     HWND        hwndOwner;
 204     LPCITEMIDLIST pidlRoot;
 205     LPWSTR        pszDisplayName;
 206     LPCWSTR       lpszTitle;
 207     UINT        ulFlags;
 208     BFFCALLBACK   lpfn;
 209     LPARAM        lParam;
 210     INT         iImage;
 211 } BROWSEINFOW, *PBROWSEINFOW, *LPBROWSEINFOW;
 212
 213 #define BROWSEINFO   WINELIB_NAME_AW(BROWSEINFO)
 214 #define PBROWSEINFO  WINELIB_NAME_AW(PBROWSEINFO)
 215 #define LPBROWSEINFO WINELIB_NAME_AW(LPBROWSEINFO)
 216
 217 /* Browsing for directory. */
 218 #define BIF_RETURNONLYFSDIRS   0x0001
 219 #define BIF_DONTGOBELOWDOMAIN  0x0002
 220 #define BIF_STATUSTEXT         0x0004
 221 #define BIF_RETURNFSANCESTORS  0x0008
 222 #define BIF_EDITBOX            0x0010
 223 #define BIF_VALIDATE           0x0020
 224
 225 #define BIF_BROWSEFORCOMPUTER  0x1000
 226 #define BIF_BROWSEFORPRINTER   0x2000
 227 #define BIF_BROWSEINCLUDEFILES 0x4000
 228
 229 /* message from browser */
 230 #define BFFM_INITIALIZED        1
 231 #define BFFM_SELCHANGED         2
 232 #define BFFM_VALIDATEFAILEDA    3   /* lParam:szPath ret:1(cont),0(EndDialog) */
 233 #define BFFM_VALIDATEFAILEDW    4   /* lParam:wzPath ret:1(cont),0(EndDialog) */
 234
 235 /* messages to browser */
 236 #define BFFM_SETSTATUSTEXTA     (WM_USER+100)
 237 #define BFFM_ENABLEOK           (WM_USER+101)
 238 #define BFFM_SETSELECTIONA      (WM_USER+102)
 239 #define BFFM_SETSELECTIONW      (WM_USER+103)
 240 #define BFFM_SETSTATUSTEXTW     (WM_USER+104)
 241
 242 /*
 243 #ifdef UNICODE
 244 #define SHBrowseForFolder   SHBrowseForFolderW
 245 #define BFFM_SETSTATUSTEXT  BFFM_SETSTATUSTEXTW
 246 #define BFFM_SETSELECTION   BFFM_SETSELECTIONW
 247
 248 #define BFFM_VALIDATEFAILED BFFM_VALIDATEFAILEDW
 249 #else
 250 #define SHBrowseForFolder   SHBrowseForFolderA
 251 #define BFFM_SETSTATUSTEXT  BFFM_SETSTATUSTEXTA
 252 #define BFFM_SETSELECTION   BFFM_SETSELECTIONA
 253
 254 #define BFFM_VALIDATEFAILED BFFM_VALIDATEFAILEDA
 255 #endif
 256 */
 257
 258 LPITEMIDLIST WINAPI SHBrowseForFolderA(LPBROWSEINFOA lpbi);
 259 LPITEMIDLIST WINAPI SHBrowseForFolder32W(LPBROWSEINFOW lpbi);
 260 #define  SHBrowseForFolder WINELIB_NAME_AW(SHBrowseForFolder)
 261
 262 /****************************************************************************
 263 *       SHGetDataFromIDList API
 264 */
 265 #define SHGDFIL_FINDDATA        1
 266 #define SHGDFIL_NETRESOURCE     2
 267 #define SHGDFIL_DESCRIPTIONID   3
 268
 269 #define SHDID_ROOT_REGITEM          1
 270 #define SHDID_FS_FILE               2
 271 #define SHDID_FS_DIRECTORY          3
 272 #define SHDID_FS_OTHER              4
 273 #define SHDID_COMPUTER_DRIVE35      5
 274 #define SHDID_COMPUTER_DRIVE525     6
 275 #define SHDID_COMPUTER_REMOVABLE    7
 276 #define SHDID_COMPUTER_FIXED        8
 277 #define SHDID_COMPUTER_NETDRIVE     9
 278 #define SHDID_COMPUTER_CDROM        10
 279 #define SHDID_COMPUTER_RAMDISK      11
 280 #define SHDID_COMPUTER_OTHER        12
 281 #define SHDID_NET_DOMAIN            13
 282 #define SHDID_NET_SERVER            14
 283 #define SHDID_NET_SHARE             15
 284 #define SHDID_NET_RESTOFNET         16
 285 #define SHDID_NET_OTHER             17
 286
 287 typedef struct _SHDESCRIPTIONID
 288 {   DWORD   dwDescriptionId;
 289     CLSID   clsid;
 290 } SHDESCRIPTIONID, *LPSHDESCRIPTIONID;
 291
 292 HRESULT WINAPI SHGetDataFromIDListA(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID pv, int cb);
 293 HRESULT WINAPI SHGetDataFromIDListW(LPSHELLFOLDER psf, LPCITEMIDLIST pidl, int nFormat, LPVOID pv, int cb);
 294 #define  SHGetDataFromIDList WINELIB_NAME_AW(SHGetDataFromIDList)
 295
 296 BOOL WINAPI SHGetSpecialFolderPathA (HWND hwndOwner,LPSTR szPath,DWORD csidl,BOOL bCreate);
 297 BOOL WINAPI SHGetSpecialFolderPathW (HWND hwndOwner,LPWSTR szPath,DWORD csidl,BOOL bCreate);
 298 #define  SHGetSpecialFolderPath WINELIB_NAME_AW(SHGetSpecialFolderPath)
 299
 300 HRESULT WINAPI SHGetSpecialFolderLocation(HWND hwndOwner, INT nFolder, LPITEMIDLIST * ppidl);
 301
 302 /****************************************************************************
 303 * shlview structures
 304 */
 305
 306 /*
 307 * IShellFolderViewCallback Callback
 308 *  This "callback" is called by the shells default IShellView implementation (that
 309 *  we got using SHCreateShellViewEx()), to notify us of the various things that
 310 *  are happening to the shellview (and ask for things too).
 311 *
 312 *  You don't have to support anything here - anything you don't want to
 313 *  handle, the shell will do itself if you just return E_NOTIMPL. This parameters
 314 *  that the shell passes to this function are entirely undocumented.
 315 *
 316 *  HOWEVER, as the cabview sample as originally written used this callback, the
 317 *  writers implemented the callback mechanism on top of their own IShellView.
 318 *  Look there for some clues on what to do here.
 319 */
 320
 321 typedef HRESULT(CALLBACK *SHELLVIEWPROC)(DWORD dwUserParam,LPSHELLFOLDER psf,
 322                          HWND hwnd,UINT uMsg,UINT wParam,LPARAM lParam);
 323
 324 /* NF valid values for the "viewmode" item of the SHELLTEMPLATE*/
 325 #define NF_INHERITVIEW    0x0000
 326 #define NF_LOCALVIEW        0x0001
 327
 328 typedef struct _SHELLVIEWDATA   /* idl */
 329 { DWORD           dwSize;
 330   LPSHELLFOLDER   pShellFolder;
 331   DWORD           dwUserParam;
 332   LPCITEMIDLIST   pidl;
 333   DWORD           v3;        /* always 0 */
 334   SHELLVIEWPROC   pCallBack;
 335   DWORD           viewmode;  /* NF_* enum */
 336 } SHELLVIEWDATA, * LPSHELLVIEWDATA;
 337
 338 DWORD WINAPI SHGetMalloc(LPMALLOC *lpmal) ;
 339
 340 /**********************************************************************
 341  * SHGetSettings ()
 342  */
 343 typedef struct
 344 {       BOOL fShowAllObjects : 1;
 345         BOOL fShowExtensions : 1;
 346         BOOL fNoConfirmRecycle : 1;
 347         BOOL fShowSysFiles : 1;
 348
 349         BOOL fShowCompColor : 1;
 350         BOOL fDoubleClickInWebView : 1;
 351         BOOL fDesktopHTML : 1;
 352         BOOL fWin95Classic : 1;
 353
 354         BOOL fDontPrettyPath : 1;
 355         BOOL fShowAttribCol : 1;
 356         BOOL fMapNetDrvBtn : 1;
 357         BOOL fShowInfoTip : 1;
 358
 359         BOOL fHideIcons : 1;
 360         UINT fRestFlags : 3;
 361 } SHELLFLAGSTATE, * LPSHELLFLAGSTATE;
 362
 363 void WINAPI SHGetSettings(LPSHELLFLAGSTATE lpsfs, DWORD dwMask, DWORD dwx);
 364
 365 #define SSF_SHOWALLOBJECTS              0x0001
 366 #define SSF_SHOWEXTENSIONS              0x0002
 367 #define SSF_SHOWCOMPCOLOR               0x0008
 368 #define SSF_SHOWSYSFILES                0x0020
 369 #define SSF_DOUBLECLICKINWEBVIEW        0x0080
 370 #define SSF_SHOWATTRIBCOL               0x0100
 371 #define SSF_DESKTOPHTML                 0x0200
 372 #define SSF_WIN95CLASSIC                0x0400
 373 #define SSF_DONTPRETTYPATH              0x0800
 374 #define SSF_SHOWINFOTIP                 0x2000
 375 #define SSF_MAPNETDRVBUTTON             0x1000
 376 #define SSF_NOCONFIRMRECYCLE            0x8000
 377 #define SSF_HIDEICONS                   0x4000
 378
 379 /**********************************************************************
 380  * SHChangeNotify
 381  */
 382 #define SHCNE_RENAMEITEM        0x00000001
 383 #define SHCNE_CREATE            0x00000002
 384 #define SHCNE_DELETE            0x00000004
 385 #define SHCNE_MKDIR             0x00000008
 386 #define SHCNE_RMDIR             0x00000010
 387 #define SHCNE_MEDIAINSERTED     0x00000020
 388 #define SHCNE_MEDIAREMOVED      0x00000040
 389 #define SHCNE_DRIVEREMOVED      0x00000080
 390 #define SHCNE_DRIVEADD          0x00000100
 391 #define SHCNE_NETSHARE          0x00000200
 392 #define SHCNE_NETUNSHARE        0x00000400
 393 #define SHCNE_ATTRIBUTES        0x00000800
 394 #define SHCNE_UPDATEDIR         0x00001000
 395 #define SHCNE_UPDATEITEM        0x00002000
 396 #define SHCNE_SERVERDISCONNECT  0x00004000
 397 #define SHCNE_UPDATEIMAGE       0x00008000
 398 #define SHCNE_DRIVEADDGUI       0x00010000
 399 #define SHCNE_RENAMEFOLDER      0x00020000
 400 #define SHCNE_FREESPACE         0x00040000
 401
 402 #define SHCNE_EXTENDED_EVENT    0x04000000
 403 #define SHCNE_ASSOCCHANGED      0x08000000
 404 #define SHCNE_DISKEVENTS        0x0002381F
 405 #define SHCNE_GLOBALEVENTS      0x0C0581E0
 406 #define SHCNE_ALLEVENTS         0x7FFFFFFF
 407 #define SHCNE_INTERRUPT         0x80000000
 408
 409 #define SHCNEE_ORDERCHANGED     0x00000002
 410
 411 #define SHCNF_IDLIST            0x0000
 412 #define SHCNF_PATHA             0x0001
 413 #define SHCNF_PRINTERA          0x0002
 414 #define SHCNF_DWORD             0x0003
 415 #define SHCNF_PATHW             0x0005
 416 #define SHCNF_PRINTERW          0x0006
 417 #define SHCNF_TYPE              0x00FF
 418 #define SHCNF_FLUSH             0x1000
 419 #define SHCNF_FLUSHNOWAIT       0x2000
 420
 421 void WINAPI SHChangeNotifyA(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2);
 422 void WINAPI SHChangeNotifyW(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2);
 423 #define  SHChangeNotify WINELIB_NAME_AW(SHChangeNotify)
 424
 425  /**********************************************************************/
 426
 427 #ifdef __cplusplus
 428 } /* extern "C" */
 429 #endif /* defined(__cplusplus) */
 430
 431 #endif /* __WINE_SHLOBJ_H */