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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19 #ifndef __WINE_SHELLAPI_H
20 #define __WINE_SHELLAPI_H
24 #endif /* defined(__cplusplus) */
30 DECLARE_HANDLE(HDROP);
32 /******************************************
36 typedef struct _DRAGINFOA
42 } DRAGINFOA, *LPDRAGINFOA;
44 typedef struct _DRAGINFOW
50 } DRAGINFOW, *LPDRAGINFOW;
52 DECL_WINELIB_TYPE_AW(DRAGINFO)
53 DECL_WINELIB_TYPE_AW(LPDRAGINFO)
55 void WINAPI DragAcceptFiles(HWND hWnd, BOOL b);
56 UINT WINAPI DragQueryFileA(HDROP hDrop, UINT lFile, LPSTR lpszFile, UINT lLength);
57 UINT WINAPI DragQueryFileW(HDROP hDrop, UINT lFile, LPWSTR lpszFile, UINT lLength);
58 #define DragQueryFile WINELIB_NAME_AW(DragQueryFile)
59 void WINAPI DragFinish(HDROP h);
60 BOOL WINAPI DragQueryPoint(HDROP hDrop, POINT *p);
64 /******************************************
67 #define ABM_NEW 0x00000000
68 #define ABM_REMOVE 0x00000001
69 #define ABM_QUERYPOS 0x00000002
70 #define ABM_SETPOS 0x00000003
71 #define ABM_GETSTATE 0x00000004
72 #define ABM_GETTASKBARPOS 0x00000005
73 #define ABM_ACTIVATE 0x00000006
74 #define ABM_GETAUTOHIDEBAR 0x00000007
75 #define ABM_SETAUTOHIDEBAR 0x00000008
76 #define ABM_WINDOWPOSCHANGED 0x00000009
78 #define ABN_STATECHANGE 0x00000000
79 #define ABN_POSCHANGED 0x00000001
80 #define ABN_FULLSCREENAPP 0x00000002
81 #define ABN_WINDOWARRANGE 0x00000003
83 #define ABS_AUTOHIDE 0x00000001
84 #define ABS_ALWAYSONTOP 0x00000002
91 typedef struct _AppBarData
94 UINT uCallbackMessage;
98 } APPBARDATA, *PAPPBARDATA;
100 UINT_PTR WINAPI SHAppBarMessage(DWORD,PAPPBARDATA);
102 /******************************************
106 #define SHGFI_LARGEICON 0x000000000 /* get large icon */
107 #define SHGFI_SMALLICON 0x000000001 /* get small icon */
108 #define SHGFI_OPENICON 0x000000002 /* get open icon */
109 #define SHGFI_SHELLICONSIZE 0x000000004 /* get shell size icon */
110 #define SHGFI_PIDL 0x000000008 /* pszPath is a pidl */
111 #define SHGFI_USEFILEATTRIBUTES 0x000000010 /* use passed dwFileAttribute */
112 #define SHGFI_ADDOVERLAYS 0x000000020
113 #define SHGFI_OVERLAYINDEX 0x000000040
114 #define SHGFI_ICON 0x000000100 /* get icon */
115 #define SHGFI_DISPLAYNAME 0x000000200 /* get display name */
116 #define SHGFI_TYPENAME 0x000000400 /* get type name */
117 #define SHGFI_ATTRIBUTES 0x000000800 /* get attributes */
118 #define SHGFI_ICONLOCATION 0x000001000 /* get icon location */
119 #define SHGFI_EXETYPE 0x000002000 /* return exe type */
120 #define SHGFI_SYSICONINDEX 0x000004000 /* get system icon index */
121 #define SHGFI_LINKOVERLAY 0x000008000 /* put a link overlay on icon */
122 #define SHGFI_SELECTED 0x000010000 /* show icon in selected state */
123 #define SHGFI_ATTR_SPECIFIED 0x000020000 /* get only specified attributes */
125 typedef struct tagSHFILEINFOA
126 { HICON hIcon; /* icon */
127 int iIcon; /* icon index */
128 DWORD dwAttributes; /* SFGAO_ flags */
129 CHAR szDisplayName[MAX_PATH];/* display name (or path) */
130 CHAR szTypeName[80]; /* type name */
133 typedef struct tagSHFILEINFOW
134 { HICON hIcon; /* icon */
135 int iIcon; /* icon index */
136 DWORD dwAttributes; /* SFGAO_ flags */
137 WCHAR szDisplayName[MAX_PATH];/* display name (or path) */
138 WCHAR szTypeName[80]; /* type name */
141 DECL_WINELIB_TYPE_AW(SHFILEINFO)
143 DWORD_PTR WINAPI SHGetFileInfoA(LPCSTR,DWORD,SHFILEINFOA*,UINT,UINT);
144 DWORD_PTR WINAPI SHGetFileInfoW(LPCWSTR,DWORD,SHFILEINFOW*,UINT,UINT);
145 #define SHGetFileInfo WINELIB_NAME_AW(SHGetFileInfo)
147 /******************************************
151 HRESULT WINAPI SHGetImageList(INT, REFIID, void **);
153 #define SHIL_LARGE 0x0
154 #define SHIL_SMALL 0x1
155 #define SHIL_EXTRALARGE 0x2
156 #define SHIL_SYSSMALL 0x3
157 #define SHIL_JUMBO 0x4
158 #define SHIL_LAST SHIL_JUMBO
160 /******************************************
164 /******************************************
167 #define FO_MOVE 0x0001
168 #define FO_COPY 0x0002
169 #define FO_DELETE 0x0003
170 #define FO_RENAME 0x0004
172 #define FOF_MULTIDESTFILES 0x0001
173 #define FOF_CONFIRMMOUSE 0x0002
174 #define FOF_SILENT 0x0004
175 #define FOF_RENAMEONCOLLISION 0x0008
176 #define FOF_NOCONFIRMATION 0x0010
177 #define FOF_WANTMAPPINGHANDLE 0x0020
178 #define FOF_ALLOWUNDO 0x0040
179 #define FOF_FILESONLY 0x0080
180 #define FOF_SIMPLEPROGRESS 0x0100
181 #define FOF_NOCONFIRMMKDIR 0x0200
182 #define FOF_NOERRORUI 0x0400
183 #define FOF_NOCOPYSECURITYATTRIBS 0x0800
184 #define FOF_NORECURSION 0x1000 /* don't do recursion into directories */
185 #define FOF_NO_CONNECTED_ELEMENTS 0x2000 /* don't do connected files */
186 #define FOF_WANTNUKEWARNING 0x4000 /* during delete operation, warn if delete instead
187 of recycling (even if FOF_NOCONFIRMATION) */
188 #define FOF_NORECURSEREPARSE 0x8000 /* don't do recursion into reparse points */
189 #define FOF_NO_UI (FOF_SILENT | FOF_NOCONFIRMATION | FOF_NOERRORUI | FOF_NOCONFIRMMKDIR)
191 typedef WORD FILEOP_FLAGS;
193 #define PO_DELETE 0x0013
194 #define PO_RENAME 0x0014
195 #define PO_PORTCHANGE 0x0020
196 #define PO_REN_PORT (PO_RENAME | PO_PORTCHANGE)
198 typedef WORD PRINTEROP_FLAGS;
200 typedef struct _SHFILEOPSTRUCTA
206 BOOL fAnyOperationsAborted;
207 LPVOID hNameMappings;
208 LPCSTR lpszProgressTitle;
209 } SHFILEOPSTRUCTA, *LPSHFILEOPSTRUCTA;
211 typedef struct _SHFILEOPSTRUCTW
217 BOOL fAnyOperationsAborted;
218 LPVOID hNameMappings;
219 LPCWSTR lpszProgressTitle;
220 } SHFILEOPSTRUCTW, *LPSHFILEOPSTRUCTW;
222 #define SHFILEOPSTRUCT WINELIB_NAME_AW(SHFILEOPSTRUCT)
223 #define LPSHFILEOPSTRUCT WINELIB_NAME_AW(LPSHFILEOPSTRUCT)
225 int WINAPI SHFileOperationA (LPSHFILEOPSTRUCTA lpFileOp);
226 int WINAPI SHFileOperationW (LPSHFILEOPSTRUCTW lpFileOp);
227 #define SHFileOperation WINELIB_NAME_AW(SHFileOperation)
229 typedef struct _SHNAMEMAPPINGA
235 } SHNAMEMAPPINGA, *LPSHNAMEMAPPINGA;
237 typedef struct _SHNAMEMAPPINGW
243 } SHNAMEMAPPINGW, *LPSHNAMEMAPPINGW;
245 DECL_WINELIB_TYPE_AW(SHNAMEMAPPING)
246 DECL_WINELIB_TYPE_AW(LPSHNAMEMAPPING)
248 void WINAPI SHFreeNameMappings(HANDLE hNameMappings);
250 /******************************************
253 #define SE_ERR_SHARE 26
254 #define SE_ERR_ASSOCINCOMPLETE 27
255 #define SE_ERR_DDETIMEOUT 28
256 #define SE_ERR_DDEFAIL 29
257 #define SE_ERR_DDEBUSY 30
258 #define SE_ERR_NOASSOC 31
260 HINSTANCE WINAPI ShellExecuteA(HWND,LPCSTR,LPCSTR,LPCSTR,LPCSTR,INT);
261 HINSTANCE WINAPI ShellExecuteW(HWND,LPCWSTR,LPCWSTR,LPCWSTR,LPCWSTR,INT);
262 #define ShellExecute WINELIB_NAME_AW(ShellExecute)
264 #define SE_ERR_FNF 2 /* file not found */
265 #define SE_ERR_PNF 3 /* path not found */
266 #define SE_ERR_ACCESSDENIED 5 /* access denied */
267 #define SE_ERR_OOM 8 /* out of memory */
268 #define SE_ERR_DLLNOTFOUND 32
269 #define SE_ERR_SHARE 26
270 #define SE_ERR_ASSOCINCOMPLETE 27
271 #define SE_ERR_DDETIMEOUT 28
272 #define SE_ERR_DDEFAIL 29
273 #define SE_ERR_DDEBUSY 30
274 #define SE_ERR_NOASSOC 31
276 #define SEE_MASK_CLASSNAME 0x00000001
277 #define SEE_MASK_CLASSKEY 0x00000003
278 #define SEE_MASK_IDLIST 0x00000004
279 #define SEE_MASK_INVOKEIDLIST 0x0000000c
280 #define SEE_MASK_ICON 0x00000010
281 #define SEE_MASK_HOTKEY 0x00000020
282 #define SEE_MASK_NOCLOSEPROCESS 0x00000040
283 #define SEE_MASK_CONNECTNETDRV 0x00000080
284 #define SEE_MASK_NOASYNC 0x00000100
285 #define SEE_MASK_FLAG_DDEWAIT SEE_MASK_NOASYNC
286 #define SEE_MASK_DOENVSUBST 0x00000200
287 #define SEE_MASK_FLAG_NO_UI 0x00000400
288 #define SEE_MASK_UNICODE 0x00004000
289 #define SEE_MASK_NO_CONSOLE 0x00008000
290 #define SEE_MASK_ASYNCOK 0x00100000
291 #define SEE_MASK_HMONITOR 0x00200000
292 #define SEE_MASK_NOZONECHECKS 0x00800000
293 #define SEE_MASK_NOQUERYCLASSSTORE 0x01000000
294 #define SEE_MASK_WAITFORINPUTIDLE 0x02000000
295 #define SEE_MASK_FLAG_LOG_USAGE 0x04000000
297 typedef struct _SHELLEXECUTEINFOA
307 /* Optional fields */
317 } SHELLEXECUTEINFOA, *LPSHELLEXECUTEINFOA;
319 typedef struct _SHELLEXECUTEINFOW
325 LPCWSTR lpParameters;
339 } SHELLEXECUTEINFOW, *LPSHELLEXECUTEINFOW;
341 #define SHELLEXECUTEINFO WINELIB_NAME_AW(SHELLEXECUTEINFO)
342 #define LPSHELLEXECUTEINFO WINELIB_NAME_AW(LPSHELLEXECUTEINFO)
344 BOOL WINAPI ShellExecuteExA(LPSHELLEXECUTEINFOA lpExecInfo);
345 BOOL WINAPI ShellExecuteExW(LPSHELLEXECUTEINFOW lpExecInfo);
346 #define ShellExecuteEx WINELIB_NAME_AW(ShellExecuteEx)
348 void WINAPI WinExecErrorA(HWND hwnd,INT error, LPCSTR lpstrFileName, LPCSTR lpstrTitle);
349 void WINAPI WinExecErrorW(HWND hwnd,INT error, LPCWSTR lpstrFileName, LPCWSTR lpstrTitle);
350 #define WinExecError WINELIB_NAME_AW(WinExecError)
352 /******************************************
355 /* notifyicondata.uFlags values*/
356 #define NIF_MESSAGE 0x00000001
357 #define NIF_ICON 0x00000002
358 #define NIF_TIP 0x00000004
359 #define NIF_STATE 0x00000008
360 #define NIF_INFO 0x00000010
361 #define NIF_GUID 0x00000020
362 #define NIF_REALTIME 0x00000040
363 #define NIF_SHOWTIP 0x00000080
365 /* notifyicondata.dwState values */
366 #define NIS_HIDDEN 0x00000001
367 #define NIS_SHAREDICON 0x00000002
369 /* notifyicondata.dwInfoFlags values */
370 #define NIIF_NONE 0x00000000
371 #define NIIF_INFO 0x00000001
372 #define NIIF_WARNING 0x00000002
373 #define NIIF_ERROR 0x00000003
374 #define NIIF_USER 0x00000004
375 #define NIIF_ICONMASK 0x0000000f
376 #define NIIF_NOSOUND 0x00000010
377 #define NIIF_LARGEICON 0x00000020
379 /* dwMessage values */
380 #define NIM_ADD 0x00000000
381 #define NIM_MODIFY 0x00000001
382 #define NIM_DELETE 0x00000002
383 #define NIM_SETFOCUS 0x00000003
384 #define NIM_SETVERSION 0x00000004
386 #define NOTIFY_VERSION 3 /* supported by Windows 2000 and later */
387 #define NOTIFY_VERSION_4 4 /* supported by Windows Vista */
389 /* callback message lParam values */
390 #define NIN_SELECT (WM_USER+0)
392 #define NIN_KEYSELECT (NIN_SELECT|NINF_KEY) /* WM_USER+1 */
393 #define NIN_BALOONSHOW (WM_USER+2)
394 #define NIN_BALOONHIDE (WM_USER+3)
395 #define NIN_BALOONTIMEOUT (WM_USER+4)
396 #define NIN_BALOONCLICK (WM_USER+5)
397 #define NIN_POPUPOPEN (WM_USER+6)
398 #define NIN_POPUPCLOSE (WM_USER+7)
400 typedef struct _NOTIFYICONDATAA
405 UINT uCallbackMessage;
415 CHAR szInfoTitle[64];
419 } NOTIFYICONDATAA, *PNOTIFYICONDATAA;
421 typedef struct _NOTIFYICONDATAW
426 UINT uCallbackMessage;
436 WCHAR szInfoTitle[64];
440 } NOTIFYICONDATAW, *PNOTIFYICONDATAW;
442 DECL_WINELIB_TYPE_AW(NOTIFYICONDATA)
443 DECL_WINELIB_TYPE_AW(PNOTIFYICONDATA)
445 BOOL WINAPI Shell_NotifyIconA(DWORD dwMessage, PNOTIFYICONDATAA lpData);
446 BOOL WINAPI Shell_NotifyIconW(DWORD dwMessage, PNOTIFYICONDATAW lpData);
448 #define Shell_NotifyIcon WINELIB_NAME_AW(Shell_NotifyIcon)
451 #define NOTIFYICONDATAA_V1_SIZE FIELD_OFFSET(NOTIFYICONDATAA, szTip[64])
452 #define NOTIFYICONDATAW_V1_SIZE FIELD_OFFSET(NOTIFYICONDATAW, szTip[64])
455 #define NOTIFYICONDATAA_V2_SIZE FIELD_OFFSET(NOTIFYICONDATAA, guidItem)
456 #define NOTIFYICONDATAW_V2_SIZE FIELD_OFFSET(NOTIFYICONDATAW, guidItem)
458 /* pre Window Vista */
459 #define NOTIFYICONDATAA_V3_SIZE FIELD_OFFSET(NOTIFYICONDATAA, hBalloonIcon)
460 #define NOTIFYICONDATAW_V3_SIZE FIELD_OFFSET(NOTIFYICONDATAW, hBalloonIcon)
463 /******************************************
467 #define SHGNLI_PIDL 0x01
468 #define SHGNLI_PREFIXNAME 0x02
469 #define SHGNLI_NOUNIQUE 0x04
470 #define SHGNLI_NOLNK 0x08
472 BOOL WINAPI SHGetNewLinkInfoA(LPCSTR,LPCSTR,LPSTR,BOOL*,UINT);
473 BOOL WINAPI SHGetNewLinkInfoW(LPCWSTR,LPCWSTR,LPWSTR,BOOL*,UINT);
474 #define SHGetNewLinkInfo WINELIB_NAME_AW(SHGetNewLinkInfo)
476 /******************************************
480 typedef struct _SHQUERYRBINFO
484 DWORDLONG i64NumItems;
485 } SHQUERYRBINFO, *LPSHQUERYRBINFO;
487 HRESULT WINAPI SHEmptyRecycleBinA(HWND,LPCSTR,DWORD);
488 HRESULT WINAPI SHEmptyRecycleBinW(HWND,LPCWSTR,DWORD);
489 #define SHEmptyRecycleBin WINELIB_NAME_AW(SHEmptyRecycleBin)
490 HRESULT WINAPI SHQueryRecycleBinA(LPCSTR,LPSHQUERYRBINFO);
491 HRESULT WINAPI SHQueryRecycleBinW(LPCWSTR,LPSHQUERYRBINFO);
492 #define SHQueryRecycleBin WINELIB_NAME_AW(SHQueryRecycleBin)
494 /******************************************
498 LPWSTR* WINAPI CommandLineToArgvW(LPCWSTR,int*);
499 HICON WINAPI ExtractIconA(HINSTANCE,LPCSTR,UINT);
500 HICON WINAPI ExtractIconW(HINSTANCE,LPCWSTR,UINT);
501 #define ExtractIcon WINELIB_NAME_AW(ExtractIcon)
502 HICON WINAPI ExtractAssociatedIconA(HINSTANCE,LPSTR,LPWORD);
503 HICON WINAPI ExtractAssociatedIconW(HINSTANCE,LPWSTR,LPWORD);
504 #define ExtractAssociatedIcon WINELIB_NAME_AW(ExtractAssociatedIcon)
505 HICON WINAPI ExtractAssociatedIconExA(HINSTANCE,LPSTR,LPWORD,LPWORD);
506 HICON WINAPI ExtractAssociatedIconExW(HINSTANCE,LPWSTR,LPWORD,LPWORD);
507 #define ExtractAssociatedIconEx WINELIB_NAME_AW(ExtractAssociatedIconEx)
508 UINT WINAPI ExtractIconExA(LPCSTR,INT,HICON*,HICON*,UINT);
509 UINT WINAPI ExtractIconExW(LPCWSTR,INT,HICON*,HICON*,UINT);
510 #define ExtractIconEx WINELIB_NAME_AW(ExtractIconEx)
511 HINSTANCE WINAPI FindExecutableA(LPCSTR,LPCSTR,LPSTR);
512 HINSTANCE WINAPI FindExecutableW(LPCWSTR,LPCWSTR,LPWSTR);
513 #define FindExecutable WINELIB_NAME_AW(FindExecutable)
514 BOOL WINAPI ShellAboutA(HWND,LPCSTR,LPCSTR,HICON);
515 BOOL WINAPI ShellAboutW(HWND,LPCWSTR,LPCWSTR,HICON);
516 #define ShellAbout WINELIB_NAME_AW(ShellAbout)
517 int WINAPIV ShellMessageBoxA(HINSTANCE,HWND,LPCSTR,LPCSTR,UINT,...);
518 int WINAPIV ShellMessageBoxW(HINSTANCE,HWND,LPCWSTR,LPCWSTR,UINT,...);
519 #define ShellMessageBox WINELIB_NAME_AW(ShellMessageBox)
520 DWORD WINAPI DoEnvironmentSubstA(LPSTR, UINT);
521 DWORD WINAPI DoEnvironmentSubstW(LPWSTR, UINT);
522 #define DoEnvironmentSubst WINELIB_NAME_AW(DoEnvironmentSubst)
527 #endif /* defined(__cplusplus) */
533 #endif /* __WINE_SHELLAPI_H */