source: trunk/src/shell32/shell32.h@ 398

Last change on this file since 398 was 183, checked in by phaller, 26 years ago

Add: even more SHELL32 APIs ... and some corrections
File size: 13.4 KB
Line 
1/* $Id: shell32.h,v 1.4 1999-06-24 19:27:49 phaller Exp $ */
2
3#ifndef __shell32_H__
4#define __shell32_H__
5
6#define LPMALLOC void *
7
8typedef struct
9{
10 WORD cb; /* nr of bytes in this item */
11 BYTE abID[1]; /* first byte in this item */
12} SHITEMID, *LPSHITEMID;
13
14
15typedef struct
16{
17 SHITEMID mkid; /* first itemid in list */
18} ITEMIDLIST, *LPITEMIDLIST, *LPCITEMIDLIST;
19
20
21typedef int (* WIN32API BFFCALLBACK)(HWND hwnd, UINT uMsg, LPARAM lParam, LPARAM lpData);
22
23typedef struct _browseinfoA
24{
25 HWND hwndOwner;
26 LPCITEMIDLIST pidlRoot;
27 LPSTR pszDisplayName;// Return display name of item selected.
28 LPCSTR lpszTitle; // text to go in the banner over the tree.
29 UINT ulFlags; // Flags that control the return stuff
30 BFFCALLBACK lpfn;
31 LPARAM lParam; // extra info that's passed back in callbacks
32
33 int iImage; // output var: where to return the Image index.
34} BROWSEINFOA, *PBROWSEINFOA, *LPBROWSEINFOA;
35
36typedef struct _browseinfoW
37{
38 HWND hwndOwner;
39 LPCITEMIDLIST pidlRoot;
40 LPWSTR pszDisplayName;// Return display name of item selected.
41 LPCWSTR lpszTitle; // text to go in the banner over the tree.
42 UINT ulFlags; // Flags that control the return stuff
43 BFFCALLBACK lpfn;
44 LPARAM lParam; // extra info that's passed back in callbacks
45
46 int iImage; // output var: where to return the Image index.
47} BROWSEINFOW, *PBROWSEINFOW, *LPBROWSEINFOW;
48
49// Browsing for directory.
50#define BIF_RETURNONLYFSDIRS 0x0001 // For finding a folder to start document searching
51#define BIF_DONTGOBELOWDOMAIN 0x0002 // For starting the Find Computer
52#define BIF_STATUSTEXT 0x0004
53#define BIF_RETURNFSANCESTORS 0x0008
54
55#define BIF_BROWSEFORCOMPUTER 0x1000 // Browsing for Computers.
56#define BIF_BROWSEFORPRINTER 0x2000 // Browsing for Printers
57#define BIF_BROWSEINCLUDEFILES 0x4000 // Browsing for Everything
58
59// message from browser
60#define BFFM_INITIALIZED 1
61#define BFFM_SELCHANGED 2
62
63// messages to browser
64#define BFFM_SETSTATUSTEXT (WM_USER + 100)
65#define BFFM_ENABLEOK (WM_USER + 101)
66#define BFFM_SETSELECTION (WM_USER + 102)
67
68
69
70typedef void *LPSHELLFOLDER;
71
72
73/****************************************************************************
74* STRRET (temporary, move it away)
75*/
76#define STRRET_WSTR 0x0000
77#define STRRET_OFFSETA 0x0001
78#define STRRET_CSTRA 0x0002
79#define STRRET_ASTR 0X0003
80#define STRRET_OFFSETW 0X0004
81#define STRRET_CSTRW 0X0005
82
83
84typedef struct _STRRET
85{ UINT uType; /* STRRET_xxx */
86 union
87 {
88 LPWSTR pOleStr; /* OLESTR that will be freed */
89 LPSTR pStr;
90 UINT uOffset; /* OffsetINT32o SHITEMID (ANSI) */
91 char cStr[MAX_PATH]; /* Buffer to fill in */
92 WCHAR cStrW[MAX_PATH];
93 }u;
94} STRRET,*LPSTRRET;
95
96
97
98/****************************************************************************
99 * Prototypes *
100 ****************************************************************************/
101
102HANDLE WIN32API SHFreeShared(HANDLE hmem, DWORD procID);
103DWORD WIN32API SHFree(LPVOID x);
104LPVOID WIN32API SHAlloc(DWORD len);
105HRESULT WIN32API SHGetSpecialFolderLocation(HWND hwndOwner, int nFolder, LPITEMIDLIST *ppidl);
106BOOL WIN32API SHGetPathFromIDListW(LPCITEMIDLIST pidl, LPWSTR pszPath);
107BOOL WIN32API SHGetPathFromIDListA(LPCITEMIDLIST pidl, LPSTR pszPath);
108LPSTR WIN32API PathCombineA(LPSTR szDest, LPCSTR lpszDir, LPCSTR lpszFile);
109
110
111#endif /* __shell32_h_ */
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127#if 0
128
129
130/* .ICO file ICONDIR definitions */
131
132#pragma pack(1)
133
134typedef struct
135{
136 BYTE bWidth; /* Width, in pixels, of the image */
137 BYTE bHeight; /* Height, in pixels, of the image */
138 BYTE bColorCount; /* Number of colors in image (0 if >=8bpp) */
139 BYTE bReserved; /* Reserved ( must be 0) */
140 WORD wPlanes; /* Color Planes */
141 WORD wBitCount; /* Bits per pixel */
142 DWORD dwBytesInRes; /* How many bytes in this resource? */
143 DWORD dwImageOffset; /* Where in the file is this image? */
144} icoICONDIRENTRY, *LPicoICONDIRENTRY;
145
146typedef struct
147{
148 WORD idReserved; /* Reserved (must be 0) */
149 WORD idType; /* Resource Type (1 for icons) */
150 WORD idCount; /* How many images? */
151 icoICONDIRENTRY idEntries[1]; /* An entry for each image (idCount of 'em) */
152} icoICONDIR, *LPicoICONDIR;
153
154#pragma pack(4)
155
156
157#endif
158
159
160
161
162
163
164#if 0
165#ifndef _WINE_SHLOBJ_H
166#define _WINE_SHLOBJ_H
167
168#include "shell.h"
169#include "ole.h"
170#include "ole2.h"
171#include "compobj.h"
172
173#define STDMETHOD(xfn) HRESULT (CALLBACK *fn##xfn)
174#define STDMETHOD_(type,xfn) type (CALLBACK *fn##xfn)
175#define PURE
176#define FAR
177#define THIS_ THIS,
178
179
180typedef LPVOID LPBC; /* *IBindCtx really */
181
182/*
183 * shell32 classids
184 */
185DEFINE_SHLGUID(CLSID_ShellDesktop, 0x00021400L, 0, 0);
186DEFINE_SHLGUID(CLSID_ShellLink, 0x00021401L, 0, 0);
187
188/*
189 * shell32 Interface ids
190 */
191DEFINE_SHLGUID(IID_IContextMenu, 0x000214E4L, 0, 0);
192DEFINE_SHLGUID(IID_IShellFolder, 0x000214E6L, 0, 0);
193DEFINE_SHLGUID(IID_IShellExtInit, 0x000214E8L, 0, 0);
194DEFINE_SHLGUID(IID_IShellPropSheetExt, 0x000214E9L, 0, 0);
195DEFINE_SHLGUID(IID_IExtractIcon, 0x000214EBL, 0, 0);
196DEFINE_SHLGUID(IID_IShellLink, 0x000214EEL, 0, 0);
197DEFINE_SHLGUID(IID_IShellCopyHook, 0x000214EFL, 0, 0);
198DEFINE_SHLGUID(IID_IFileViewer, 0x000214F0L, 0, 0);
199DEFINE_SHLGUID(IID_IEnumIDList, 0x000214F2L, 0, 0);
200DEFINE_SHLGUID(IID_IFileViewerSite, 0x000214F3L, 0, 0);
201
202#define STRRET_WSTR 0x0000
203#define STRRET_OFFSET 0x0001
204#define STRRET_CSTR 0x0002
205
206typedef struct _STRRET
207{
208 UINT32 uType; /* STRRET_xxx */
209 union
210 {
211 LPWSTR pOleStr; /* OLESTR that will be freed */
212 UINT32 uOffset; /* Offset into SHITEMID (ANSI) */
213 char cStr[MAX_PATH]; /* Buffer to fill in */
214 } DUMMYUNIONNAME;
215} STRRET,*LPSTRRET;
216
217/*****************************************************************************
218 * IEnumIDList interface
219 */
220#define THIS LPENUMIDLIST this
221
222typedef struct IEnumIDList IEnumIDList,*LPENUMIDLIST;
223typedef struct IEnumIDList_VTable {
224 /* *** IUnknown methods *** */
225 STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
226 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
227 STDMETHOD_(ULONG,Release) (THIS) PURE;
228
229 /* *** IEnumIDList methods *** */
230 STDMETHOD(Next) (THIS_ ULONG celt,
231 LPITEMIDLIST *rgelt,
232 ULONG *pceltFetched) PURE;
233 STDMETHOD(Skip) (THIS_ ULONG celt) PURE;
234 STDMETHOD(Reset) (THIS) PURE;
235 STDMETHOD(Clone) (THIS_ IEnumIDList **ppenum) PURE;
236} IEnumIDList_VTable,*LPENUMIDLIST_VTABLE;
237
238struct IEnumIDList {
239 LPENUMIDLIST_VTABLE lpvtbl;
240 DWORD ref;
241};
242#undef THIS
243/************************************************************************
244 * The IShellFolder interface ... the basic interface for a lot of stuff
245 */
246
247#define THIS LPSHELLFOLDER this
248
249/* IShellFolder::GetDisplayNameOf/SetNameOf uFlags */
250typedef enum
251{
252 SHGDN_NORMAL = 0, /* default (display purpose) */
253 SHGDN_INFOLDER = 1, /* displayed under a folder (relative)*/
254 SHGDN_FORPARSING = 0x8000 /* for ParseDisplayName or path */
255} SHGNO;
256
257/* IShellFolder::EnumObjects */
258typedef enum tagSHCONTF
259{
260 SHCONTF_FOLDERS = 32, /* for shell browser */
261 SHCONTF_NONFOLDERS = 64, /* for default view */
262 SHCONTF_INCLUDEHIDDEN = 128 /* for hidden/system objects */
263} SHCONTF;
264
265/* from oleidl.h */
266#define DROPEFFECT_NONE 0
267#define DROPEFFECT_COPY 1
268#define DROPEFFECT_MOVE 2
269#define DROPEFFECT_LINK 4
270#define DROPEFFECT_SCROLL 0x80000000
271
272/* IShellFolder::GetAttributesOf flags */
273#define SFGAO_CANCOPY DROPEFFECT_COPY /* Objects can be copied */
274#define SFGAO_CANMOVE DROPEFFECT_MOVE /* Objects can be moved */
275#define SFGAO_CANLINK DROPEFFECT_LINK /* Objects can be linked */
276#define SFGAO_CANRENAME 0x00000010L /* Objects can be renamed */
277#define SFGAO_CANDELETE 0x00000020L /* Objects can be deleted */
278#define SFGAO_HASPROPSHEET 0x00000040L /* Objects have property sheets */
279#define SFGAO_DROPTARGET 0x00000100L /* Objects are drop target */
280#define SFGAO_CAPABILITYMASK 0x00000177L
281#define SFGAO_LINK 0x00010000L /* Shortcut (link) */
282#define SFGAO_SHARE 0x00020000L /* shared */
283#define SFGAO_READONLY 0x00040000L /* read-only */
284#define SFGAO_GHOSTED 0x00080000L /* ghosted icon */
285#define SFGAO_DISPLAYATTRMASK 0x000F0000L
286#define SFGAO_FILESYSANCESTOR 0x10000000L /* It contains file system folder */
287#define SFGAO_FOLDER 0x20000000L /* It's a folder. */
288#define SFGAO_FILESYSTEM 0x40000000L /* is a file system thing (file/folder/root) */
289#define SFGAO_HASSUBFOLDER 0x80000000L /* Expandable in the map pane */
290#define SFGAO_CONTENTSMASK 0x80000000L
291#define SFGAO_VALIDATE 0x01000000L /* invalidate cached information */
292#define SFGAO_REMOVABLE 0x02000000L /* is this removeable media? */
293
294
295typedef struct tagSHELLFOLDER *LPSHELLFOLDER,IShellFolder;
296typedef struct IShellFolder_VTable {
297 /* *** IUnknown methods *** */
298 STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
299 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
300 STDMETHOD_(ULONG,Release) (THIS) PURE;
301
302 /* *** IShellFolder methods *** */
303 STDMETHOD(ParseDisplayName) (THIS_ HWND32 hwndOwner,
304 LPBC pbcReserved, LPOLESTR32 lpszDisplayName,
305 ULONG * pchEaten, LPITEMIDLIST * ppidl, ULONG *pdwAttributes) PURE;
306 STDMETHOD(EnumObjects) ( THIS_ HWND32 hwndOwner, DWORD grfFlags, LPENUMIDLIST
307* ppenumIDList) PURE;
308 STDMETHOD(BindToObject) (THIS_ LPCITEMIDLIST pidl, LPBC pbcReserved,
309 REFIID riid, LPVOID * ppvOut) PURE;
310 STDMETHOD(BindToStorage) (THIS_ LPCITEMIDLIST pidl, LPBC pbcReserved,
311 REFIID riid, LPVOID * ppvObj) PURE;
312 STDMETHOD(CompareIDs) (THIS_ LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2) PURE;
313 STDMETHOD(CreateViewObject) (THIS_ HWND32 hwndOwner, REFIID riid, LPVOID * ppvOut) PURE;
314 STDMETHOD(GetAttributesOf) (THIS_ UINT32 cidl, LPCITEMIDLIST * apidl,
315 ULONG * rgfInOut) PURE;
316 STDMETHOD(GetUIObjectOf) (THIS_ HWND32 hwndOwner, UINT32 cidl, LPCITEMIDLIST
317* apidl,
318 REFIID riid, UINT32 * prgfInOut, LPVOID * ppvOut) PURE;
319 STDMETHOD(GetDisplayNameOf) (THIS_ LPCITEMIDLIST pidl, DWORD uFlags, LPSTRRET lpName) PURE;
320 STDMETHOD(SetNameOf) (THIS_ HWND32 hwndOwner, LPCITEMIDLIST pidl,
321 LPCOLESTR32 lpszName, DWORD uFlags,
322 LPITEMIDLIST * ppidlOut) PURE;
323} *LPSHELLFOLDER_VTABLE,IShellFolder_VTable;
324
325struct tagSHELLFOLDER {
326 LPSHELLFOLDER_VTABLE lpvtbl;
327 DWORD ref;
328};
329
330#undef THIS
331
332/****************************************************************************
333 * IShellLink interface
334 */
335
336#define THIS LPSHELLLINK this
337/* IShellLink::Resolve fFlags */
338typedef enum {
339 SLR_NO_UI = 0x0001,
340 SLR_ANY_MATCH = 0x0002,
341 SLR_UPDATE = 0x0004
342} SLR_FLAGS;
343
344/* IShellLink::GetPath fFlags */
345typedef enum {
346 SLGP_SHORTPATH = 0x0001,
347 SLGP_UNCPRIORITY = 0x0002
348} SLGP_FLAGS;
349
350
351
352typedef struct IShellLink IShellLink,*LPSHELLLINK;
353typedef struct IShellLink_VTable
354{
355 /* *** IUnknown methods *** */
356 STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID * ppvObj) PURE;
357 STDMETHOD_(ULONG,AddRef) (THIS) PURE;
358 STDMETHOD_(ULONG,Release) (THIS) PURE;
359
360 STDMETHOD(GetPath)(THIS_ LPSTR pszFile, INT32 cchMaxPath, WIN32_FIND_DATA32A *pfd, DWORD fFlags) PURE;
361
362 STDMETHOD(GetIDList)(THIS_ LPITEMIDLIST * ppidl) PURE;
363 STDMETHOD(SetIDList)(THIS_ LPCITEMIDLIST pidl) PURE;
364
365 STDMETHOD(GetDescription)(THIS_ LPSTR pszName, int cchMaxName) PURE;
366 STDMETHOD(SetDescription)(THIS_ LPCSTR pszName) PURE;
367
368 STDMETHOD(GetWorkingDirectory)(THIS_ LPSTR pszDir, int cchMaxPath) PURE;
369 STDMETHOD(SetWorkingDirectory)(THIS_ LPCSTR pszDir) PURE;
370
371 STDMETHOD(GetArguments)(THIS_ LPSTR pszArgs, int cchMaxPath) PURE;
372 STDMETHOD(SetArguments)(THIS_ LPCSTR pszArgs) PURE;
373
374 STDMETHOD(GetHotkey)(THIS_ WORD *pwHotkey) PURE;
375 STDMETHOD(SetHotkey)(THIS_ WORD wHotkey) PURE;
376
377 STDMETHOD(GetShowCmd)(THIS_ INT32 *piShowCmd) PURE;
378 STDMETHOD(SetShowCmd)(THIS_ INT32 iShowCmd) PURE;
379
380 STDMETHOD(GetIconLocation)(THIS_ LPSTR pszIconPath, INT32 cchIconPath, INT32 *piIcon) PURE;
381 STDMETHOD(SetIconLocation)(THIS_ LPCSTR pszIconPath, INT32 iIcon) PURE;
382
383 STDMETHOD(SetRelativePath)(THIS_ LPCSTR pszPathRel, DWORD dwReserved) PURE;
384
385 STDMETHOD(Resolve)(THIS_ HWND32 hwnd, DWORD fFlags) PURE;
386
387 STDMETHOD(SetPath)(THIS_ LPCSTR pszFile) PURE;
388} IShellLink_VTable,*LPSHELLLINK_VTABLE;
389
390struct IShellLink {
391 LPSHELLLINK_VTABLE lpvtbl;
392 DWORD ref;
393};
394
395#undef THIS
396
397#ifdef __WINE__
398extern LPSHELLFOLDER IShellFolder_Constructor();
399extern LPSHELLLINK IShellLink_Constructor();
400extern LPENUMIDLIST IEnumIDList_Constructor();
401#endif
402
403DWORD WINAPI SHELL32_DllGetClassObject(LPCLSID,REFIID,LPVOID*);
404
405#undef PURE
406#undef FAR
407#undef THIS
408#undef THIS_
409#undef STDMETHOD
410#undef STDMETHOD_
411#endif /*_WINE_SHLOBJ_H*/
412
413#endif
Note: See TracBrowser for help on using the repository browser.