2 * Undocumented functions from COMCTL32.DLL
4 * Copyright 1998 Eric Kohl
5 * 1998 Juergen Schmied <j.schmied@metronet.de>
6 * 2000 Eric Kohl for CodeWeavers
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; either
11 * version 2.1 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
23 * All of these functions are UNDOCUMENTED!! And I mean UNDOCUMENTED!!!!
24 * Do NOT rely on names or contents of undocumented structures and types!!!
25 * These functions are used by EXPLORER.EXE, IEXPLORE.EXE and
26 * COMCTL32.DLL (internally).
30 #include "wine/port.h"
38 #define NONAMELESSUNION
39 #define NONAMELESSSTRUCT
51 #include "wine/unicode.h"
54 #include "wine/debug.h"
56 WINE_DEFAULT_DEBUG_CHANNEL(commctrl
);
58 static const WCHAR strMRUList
[] = { 'M','R','U','L','i','s','t',0 };
60 /**************************************************************************
63 * Allocates memory block from the dll's private heap
66 * dwSize [I] size of the allocated memory block
69 * Success: pointer to allocated memory block
72 LPVOID WINAPI
Alloc (DWORD dwSize
)
74 return LocalAlloc( LMEM_ZEROINIT
, dwSize
);
78 /**************************************************************************
79 * ReAlloc [COMCTL32.72]
81 * Changes the size of an allocated memory block or allocates a memory
82 * block using the dll's private heap.
85 * lpSrc [I] pointer to memory block which will be resized
86 * dwSize [I] new size of the memory block.
89 * Success: pointer to the resized memory block
93 * If lpSrc is a NULL-pointer, then ReAlloc allocates a memory
96 LPVOID WINAPI
ReAlloc (LPVOID lpSrc
, DWORD dwSize
)
99 return LocalReAlloc( lpSrc
, dwSize
, LMEM_ZEROINIT
| LMEM_MOVEABLE
);
101 return LocalAlloc( LMEM_ZEROINIT
, dwSize
);
105 /**************************************************************************
108 * Frees an allocated memory block from the dll's private heap.
111 * lpMem [I] pointer to memory block which will be freed
117 BOOL WINAPI
Free (LPVOID lpMem
)
119 return !LocalFree( lpMem
);
123 /**************************************************************************
124 * GetSize [COMCTL32.74]
126 * Retrieves the size of the specified memory block from the dll's
130 * lpMem [I] pointer to an allocated memory block
133 * Success: size of the specified memory block
136 DWORD WINAPI
GetSize (LPVOID lpMem
)
138 return LocalSize( lpMem
);
142 /**************************************************************************
143 * MRU-Functions {COMCTL32}
146 * The MRU-API is a set of functions to manipulate lists of M.R.U. (Most Recently
147 * Used) items. It is an undocumented API that is used (at least) by the shell
148 * and explorer to implement their recent documents feature.
150 * Since these functions are undocumented, they are unsupported by MS and
151 * may change at any time.
153 * Internally, the list is implemented as a last in, last out list of items
154 * persisted into the system registry under a caller chosen key. Each list
155 * item is given a one character identifier in the Ascii range from 'a' to
156 * '}'. A list of the identifiers in order from newest to oldest is stored
157 * under the same key in a value named "MRUList".
159 * Items are re-ordered by changing the order of the values in the MRUList
160 * value. When a new item is added, it becomes the new value of the oldest
161 * identifier, and that identifier is moved to the front of the MRUList value.
163 * Wine stores MRU-lists in the same registry format as Windows, so when
164 * switching between the builtin and native comctl32.dll no problems or
165 * incompatibilities should occur.
167 * The following undocumented structure is used to create an MRU-list:
168 *|typedef INT (CALLBACK *MRUStringCmpFn)(LPCTSTR lhs, LPCTSTR rhs);
169 *|typedef INT (CALLBACK *MRUBinaryCmpFn)(LPCVOID lhs, LPCVOID rhs, DWORD length);
171 *|typedef struct tagMRUINFO
177 *| LPTSTR lpszSubKey;
179 *|} MRUINFO, *LPMRUINFO;
182 * cbSize [I] The size of the MRUINFO structure. This must be set
183 * to sizeof(MRUINFO) by the caller.
184 * uMax [I] The maximum number of items allowed in the list. Because
185 * of the limited number of identifiers, this should be set to
186 * a value from 1 to 30 by the caller.
187 * fFlags [I] If bit 0 is set, the list will be used to store binary
188 * data, otherwise it is assumed to store strings. If bit 1
189 * is set, every change made to the list will be reflected in
190 * the registry immediately, otherwise changes will only be
191 * written when the list is closed.
192 * hKey [I] The registry key that the list should be written under.
193 * This must be supplied by the caller.
194 * lpszSubKey [I] A caller supplied name of a subkey under hKey to write
195 * the list to. This may not be blank.
196 * lpfnCompare [I] A caller supplied comparison function, which may be either
197 * an MRUStringCmpFn if dwFlags does not have bit 0 set, or a
198 * MRUBinaryCmpFn otherwise.
201 * - Create an MRU-list with CreateMRUList() or CreateMRUListLazy().
202 * - Add items to an MRU-list with AddMRUString() or AddMRUData().
203 * - Remove items from an MRU-list with DelMRUString().
204 * - Find data in an MRU-list with FindMRUString() or FindMRUData().
205 * - Iterate through an MRU-list with EnumMRUList().
206 * - Free an MRU-list with FreeMRUList().
209 typedef INT (CALLBACK
*MRUStringCmpFnA
)(LPCSTR lhs
, LPCSTR rhs
);
210 typedef INT (CALLBACK
*MRUStringCmpFnW
)(LPCWSTR lhs
, LPCWSTR rhs
);
211 typedef INT (CALLBACK
*MRUBinaryCmpFn
)(LPCVOID lhs
, LPCVOID rhs
, DWORD length
);
213 typedef struct tagMRUINFOA
222 MRUStringCmpFnA string_cmpfn
;
223 MRUBinaryCmpFn binary_cmpfn
;
225 } MRUINFOA
, *LPMRUINFOA
;
227 typedef struct tagMRUINFOW
236 MRUStringCmpFnW string_cmpfn
;
237 MRUBinaryCmpFn binary_cmpfn
;
239 } MRUINFOW
, *LPMRUINFOW
;
242 #define MRU_STRING 0 /* list will contain strings */
243 #define MRU_BINARY 1 /* list will contain binary data */
244 #define MRU_CACHEWRITE 2 /* only save list order to reg. is FreeMRUList */
246 /* If list is a string list lpfnCompare has the following prototype
247 * int CALLBACK MRUCompareString(LPCSTR s1, LPCSTR s2)
248 * for binary lists the prototype is
249 * int CALLBACK MRUCompareBinary(LPCVOID data1, LPCVOID data2, DWORD cbData)
250 * where cbData is the no. of bytes to compare.
251 * Need to check what return value means identical - 0?
254 typedef struct tagWINEMRUITEM
256 DWORD size
; /* size of data stored */
257 DWORD itemFlag
; /* flags */
259 } WINEMRUITEM
, *LPWINEMRUITEM
;
262 #define WMRUIF_CHANGED 0x0001 /* this dataitem changed */
264 typedef struct tagWINEMRULIST
266 MRUINFOW extview
; /* original create information */
267 BOOL isUnicode
; /* is compare fn Unicode */
268 DWORD wineFlags
; /* internal flags */
269 DWORD cursize
; /* current size of realMRU */
270 LPWSTR realMRU
; /* pointer to string of index names */
271 LPWINEMRUITEM
*array
; /* array of pointers to data */
272 /* in 'a' to 'z' order */
273 } WINEMRULIST
, *LPWINEMRULIST
;
276 #define WMRUF_CHANGED 0x0001 /* MRU list has changed */
278 /**************************************************************************
279 * MRU_SaveChanged (internal)
281 * Local MRU saving code
283 static void MRU_SaveChanged ( LPWINEMRULIST mp
)
290 /* or should we do the following instead of RegOpenKeyEx:
293 /* open the sub key */
294 if ((err
= RegOpenKeyExW( mp
->extview
.hKey
, mp
->extview
.lpszSubKey
,
295 0, KEY_WRITE
, &newkey
))) {
296 /* not present - what to do ??? */
297 ERR("Could not open key, error=%d, attempting to create\n",
299 if ((err
= RegCreateKeyExW( mp
->extview
.hKey
, mp
->extview
.lpszSubKey
,
302 REG_OPTION_NON_VOLATILE
,
303 KEY_READ
| KEY_WRITE
,
307 ERR("failed to create key /%s/, err=%d\n",
308 debugstr_w(mp
->extview
.lpszSubKey
), err
);
312 if (mp
->wineFlags
& WMRUF_CHANGED
) {
313 mp
->wineFlags
&= ~WMRUF_CHANGED
;
314 err
= RegSetValueExW(newkey
, strMRUList
, 0, REG_SZ
, (LPBYTE
)mp
->realMRU
,
315 (strlenW(mp
->realMRU
) + 1)*sizeof(WCHAR
));
317 ERR("error saving MRUList, err=%d\n", err
);
319 TRACE("saving MRUList=/%s/\n", debugstr_w(mp
->realMRU
));
322 for(i
=0; i
<mp
->cursize
; i
++) {
323 witem
= mp
->array
[i
];
324 if (witem
->itemFlag
& WMRUIF_CHANGED
) {
325 witem
->itemFlag
&= ~WMRUIF_CHANGED
;
326 realname
[0] = 'a' + i
;
327 err
= RegSetValueExW(newkey
, realname
, 0,
328 (mp
->extview
.fFlags
& MRU_BINARY
) ?
330 &witem
->datastart
, witem
->size
);
332 ERR("error saving /%s/, err=%d\n", debugstr_w(realname
), err
);
334 TRACE("saving value for name /%s/ size=%d\n",
335 debugstr_w(realname
), witem
->size
);
338 RegCloseKey( newkey
);
341 /**************************************************************************
342 * FreeMRUList [COMCTL32.152]
344 * Frees a most-recently-used items list.
347 * hMRUList [I] Handle to list.
352 void WINAPI
FreeMRUList (HANDLE hMRUList
)
354 LPWINEMRULIST mp
= hMRUList
;
357 TRACE("(%p)\n", hMRUList
);
361 if (mp
->wineFlags
& WMRUF_CHANGED
) {
362 /* need to open key and then save the info */
363 MRU_SaveChanged( mp
);
366 for(i
=0; i
<mp
->extview
.uMax
; i
++)
371 Free(mp
->extview
.lpszSubKey
);
376 /**************************************************************************
377 * FindMRUData [COMCTL32.169]
379 * Searches binary list for item that matches lpData of length cbData.
380 * Returns position in list order 0 -> MRU and if lpRegNum != NULL then value
381 * corresponding to item's reg. name will be stored in it ('a' -> 0).
384 * hList [I] list handle
385 * lpData [I] data to find
386 * cbData [I] length of data
387 * lpRegNum [O] position in registry (maybe NULL)
390 * Position in list 0 -> MRU. -1 if item not found.
392 INT WINAPI
FindMRUData (HANDLE hList
, LPCVOID lpData
, DWORD cbData
,
395 const WINEMRULIST
*mp
= hList
;
400 if (!mp
|| !mp
->extview
.u
.string_cmpfn
)
403 if(!(mp
->extview
.fFlags
& MRU_BINARY
) && !mp
->isUnicode
) {
404 DWORD len
= WideCharToMultiByte(CP_ACP
, 0, lpData
, -1,
405 NULL
, 0, NULL
, NULL
);
407 WideCharToMultiByte(CP_ACP
, 0, lpData
, -1, dataA
, len
, NULL
, NULL
);
410 for(i
=0; i
<mp
->cursize
; i
++) {
411 if (mp
->extview
.fFlags
& MRU_BINARY
) {
412 if (!mp
->extview
.u
.binary_cmpfn(lpData
, &mp
->array
[i
]->datastart
, cbData
))
417 if (!mp
->extview
.u
.string_cmpfn(lpData
, (LPWSTR
)&mp
->array
[i
]->datastart
))
420 DWORD len
= WideCharToMultiByte(CP_ACP
, 0,
421 (LPWSTR
)&mp
->array
[i
]->datastart
, -1,
422 NULL
, 0, NULL
, NULL
);
423 LPSTR itemA
= Alloc(len
);
425 WideCharToMultiByte(CP_ACP
, 0, (LPWSTR
)&mp
->array
[i
]->datastart
, -1,
426 itemA
, len
, NULL
, NULL
);
428 cmp
= mp
->extview
.u
.string_cmpfn((LPWSTR
)dataA
, (LPWSTR
)itemA
);
440 if (lpRegNum
&& (ret
!= -1))
443 TRACE("(%p, %p, %d, %p) returning %d\n",
444 hList
, lpData
, cbData
, lpRegNum
, ret
);
450 /**************************************************************************
451 * AddMRUData [COMCTL32.167]
453 * Add item to MRU binary list. If item already exists in list then it is
454 * simply moved up to the top of the list and not added again. If list is
455 * full then the least recently used item is removed to make room.
458 * hList [I] Handle to list.
459 * lpData [I] ptr to data to add.
460 * cbData [I] no. of bytes of data.
463 * No. corresponding to registry name where value is stored 'a' -> 0 etc.
466 INT WINAPI
AddMRUData (HANDLE hList
, LPCVOID lpData
, DWORD cbData
)
468 LPWINEMRULIST mp
= hList
;
472 if ((replace
= FindMRUData (hList
, lpData
, cbData
, NULL
)) >= 0) {
473 /* Item exists, just move it to the front */
474 LPWSTR pos
= strchrW(mp
->realMRU
, replace
+ 'a');
475 while (pos
> mp
->realMRU
)
482 /* either add a new entry or replace oldest */
483 if (mp
->cursize
< mp
->extview
.uMax
) {
484 /* Add in a new item */
485 replace
= mp
->cursize
;
489 /* get the oldest entry and replace data */
490 replace
= mp
->realMRU
[mp
->cursize
- 1] - 'a';
491 Free(mp
->array
[replace
]);
494 /* Allocate space for new item and move in the data */
495 mp
->array
[replace
] = witem
= Alloc(cbData
+ sizeof(WINEMRUITEM
));
496 witem
->itemFlag
|= WMRUIF_CHANGED
;
497 witem
->size
= cbData
;
498 memcpy( &witem
->datastart
, lpData
, cbData
);
500 /* now rotate MRU list */
501 for(i
=mp
->cursize
-1; i
>=1; i
--)
502 mp
->realMRU
[i
] = mp
->realMRU
[i
-1];
505 /* The new item gets the front spot */
506 mp
->wineFlags
|= WMRUF_CHANGED
;
507 mp
->realMRU
[0] = replace
+ 'a';
509 TRACE("(%p, %p, %d) adding data, /%c/ now most current\n",
510 hList
, lpData
, cbData
, replace
+'a');
512 if (!(mp
->extview
.fFlags
& MRU_CACHEWRITE
)) {
513 /* save changed stuff right now */
514 MRU_SaveChanged( mp
);
520 /**************************************************************************
521 * AddMRUStringW [COMCTL32.401]
523 * Add an item to an MRU string list.
526 * hList [I] Handle to list.
527 * lpszString [I] The string to add.
530 * Success: The number corresponding to the registry name where the string
531 * has been stored (0 maps to 'a', 1 to 'b' and so on).
532 * Failure: -1, if hList is NULL or memory allocation fails. If lpszString
533 * is invalid, the function returns 0, and GetLastError() returns
534 * ERROR_INVALID_PARAMETER. The last error value is set only in
538 * -If lpszString exists in the list already, it is moved to the top of the
539 * MRU list (it is not duplicated).
540 * -If the list is full the least recently used list entry is replaced with
542 * -If this function returns 0 you should check the last error value to
543 * ensure the call really succeeded.
545 INT WINAPI
AddMRUStringW(HANDLE hList
, LPCWSTR lpszString
)
547 TRACE("(%p,%s)\n", hList
, debugstr_w(lpszString
));
552 if (!lpszString
|| IsBadStringPtrW(lpszString
, -1))
554 SetLastError(ERROR_INVALID_PARAMETER
);
558 return AddMRUData(hList
, lpszString
,
559 (strlenW(lpszString
) + 1) * sizeof(WCHAR
));
562 /**************************************************************************
563 * AddMRUStringA [COMCTL32.153]
567 INT WINAPI
AddMRUStringA(HANDLE hList
, LPCSTR lpszString
)
573 TRACE("(%p,%s)\n", hList
, debugstr_a(lpszString
));
578 if (IsBadStringPtrA(lpszString
, -1))
580 SetLastError(ERROR_INVALID_PARAMETER
);
584 len
= MultiByteToWideChar(CP_ACP
, 0, lpszString
, -1, NULL
, 0) * sizeof(WCHAR
);
585 stringW
= Alloc(len
);
589 MultiByteToWideChar(CP_ACP
, 0, lpszString
, -1, stringW
, len
/sizeof(WCHAR
));
590 ret
= AddMRUData(hList
, stringW
, len
);
595 /**************************************************************************
596 * DelMRUString [COMCTL32.156]
598 * Removes item from either string or binary list (despite its name)
601 * hList [I] list handle
602 * nItemPos [I] item position to remove 0 -> MRU
605 * TRUE if successful, FALSE if nItemPos is out of range.
607 BOOL WINAPI
DelMRUString(HANDLE hList
, INT nItemPos
)
609 FIXME("(%p, %d): stub\n", hList
, nItemPos
);
613 /**************************************************************************
614 * FindMRUStringW [COMCTL32.402]
616 * See FindMRUStringA.
618 INT WINAPI
FindMRUStringW (HANDLE hList
, LPCWSTR lpszString
, LPINT lpRegNum
)
620 return FindMRUData(hList
, lpszString
,
621 (lstrlenW(lpszString
) + 1) * sizeof(WCHAR
), lpRegNum
);
624 /**************************************************************************
625 * FindMRUStringA [COMCTL32.155]
627 * Searches string list for item that matches lpszString.
628 * Returns position in list order 0 -> MRU and if lpRegNum != NULL then value
629 * corresponding to item's reg. name will be stored in it ('a' -> 0).
632 * hList [I] list handle
633 * lpszString [I] string to find
634 * lpRegNum [O] position in registry (maybe NULL)
637 * Position in list 0 -> MRU. -1 if item not found.
639 INT WINAPI
FindMRUStringA (HANDLE hList
, LPCSTR lpszString
, LPINT lpRegNum
)
641 DWORD len
= MultiByteToWideChar(CP_ACP
, 0, lpszString
, -1, NULL
, 0);
642 LPWSTR stringW
= Alloc(len
* sizeof(WCHAR
));
645 MultiByteToWideChar(CP_ACP
, 0, lpszString
, -1, stringW
, len
);
646 ret
= FindMRUData(hList
, stringW
, len
* sizeof(WCHAR
), lpRegNum
);
651 /*************************************************************************
652 * create_mru_list (internal)
654 static HANDLE
create_mru_list(LPWINEMRULIST mp
)
658 DWORD datasize
, dwdisp
;
663 /* get space to save indices that will turn into names
664 * but in order of most to least recently used
666 mp
->realMRU
= Alloc((mp
->extview
.uMax
+ 2) * sizeof(WCHAR
));
668 /* get space to save pointers to actual data in order of
669 * 'a' to 'z' (0 to n).
671 mp
->array
= Alloc(mp
->extview
.uMax
* sizeof(LPVOID
));
673 /* open the sub key */
674 if ((err
= RegCreateKeyExW( mp
->extview
.hKey
, mp
->extview
.lpszSubKey
,
677 REG_OPTION_NON_VOLATILE
,
678 KEY_READ
| KEY_WRITE
,
682 /* error - what to do ??? */
683 ERR("(%u %u %x %p %s %p): Could not open key, error=%d\n",
684 mp
->extview
.cbSize
, mp
->extview
.uMax
, mp
->extview
.fFlags
,
685 mp
->extview
.hKey
, debugstr_w(mp
->extview
.lpszSubKey
),
686 mp
->extview
.u
.string_cmpfn
, err
);
690 /* get values from key 'MRUList' */
692 datasize
= (mp
->extview
.uMax
+ 1) * sizeof(WCHAR
);
693 if((err
=RegQueryValueExW( newkey
, strMRUList
, 0, &type
,
694 (LPBYTE
)mp
->realMRU
, &datasize
))) {
695 /* not present - set size to 1 (will become 0 later) */
700 datasize
/= sizeof(WCHAR
);
702 TRACE("MRU list = %s, datasize = %d\n", debugstr_w(mp
->realMRU
), datasize
);
704 mp
->cursize
= datasize
- 1;
705 /* datasize now has number of items in the MRUList */
707 /* get actual values for each entry */
709 for(i
=0; i
<mp
->cursize
; i
++) {
710 realname
[0] = 'a' + i
;
711 if(RegQueryValueExW( newkey
, realname
, 0, &type
, 0, &datasize
)) {
712 /* not present - what to do ??? */
713 ERR("Key %s not found 1\n", debugstr_w(realname
));
715 mp
->array
[i
] = witem
= Alloc(datasize
+ sizeof(WINEMRUITEM
));
716 witem
->size
= datasize
;
717 if(RegQueryValueExW( newkey
, realname
, 0, &type
,
718 &witem
->datastart
, &datasize
)) {
719 /* not present - what to do ??? */
720 ERR("Key %s not found 2\n", debugstr_w(realname
));
723 RegCloseKey( newkey
);
728 TRACE("(%u %u %x %p %s %p): Current Size = %d\n",
729 mp
->extview
.cbSize
, mp
->extview
.uMax
, mp
->extview
.fFlags
,
730 mp
->extview
.hKey
, debugstr_w(mp
->extview
.lpszSubKey
),
731 mp
->extview
.u
.string_cmpfn
, mp
->cursize
);
735 /**************************************************************************
736 * CreateMRUListLazyW [COMCTL32.404]
738 * See CreateMRUListLazyA.
740 HANDLE WINAPI
CreateMRUListLazyW (const MRUINFOW
*infoW
, DWORD dwParam2
,
741 DWORD dwParam3
, DWORD dwParam4
)
745 /* Native does not check for a NULL lpcml */
746 if (!infoW
->hKey
|| IsBadStringPtrW(infoW
->lpszSubKey
, -1))
749 mp
= Alloc(sizeof(WINEMRULIST
));
750 memcpy(&mp
->extview
, infoW
, sizeof(MRUINFOW
));
751 mp
->extview
.lpszSubKey
= Alloc((strlenW(infoW
->lpszSubKey
) + 1) * sizeof(WCHAR
));
752 strcpyW(mp
->extview
.lpszSubKey
, infoW
->lpszSubKey
);
753 mp
->isUnicode
= TRUE
;
755 return create_mru_list(mp
);
758 /**************************************************************************
759 * CreateMRUListLazyA [COMCTL32.157]
761 * Creates a most-recently-used list.
764 * lpcml [I] ptr to CREATEMRULIST structure.
765 * dwParam2 [I] Unknown
766 * dwParam3 [I] Unknown
767 * dwParam4 [I] Unknown
770 * Handle to MRU list.
772 HANDLE WINAPI
CreateMRUListLazyA (const MRUINFOA
*lpcml
, DWORD dwParam2
,
773 DWORD dwParam3
, DWORD dwParam4
)
778 /* Native does not check for a NULL lpcml */
780 if (!lpcml
->hKey
|| IsBadStringPtrA(lpcml
->lpszSubKey
, -1))
783 mp
= Alloc(sizeof(WINEMRULIST
));
784 memcpy(&mp
->extview
, lpcml
, sizeof(MRUINFOA
));
785 len
= MultiByteToWideChar(CP_ACP
, 0, lpcml
->lpszSubKey
, -1, NULL
, 0);
786 mp
->extview
.lpszSubKey
= Alloc(len
* sizeof(WCHAR
));
787 MultiByteToWideChar(CP_ACP
, 0, lpcml
->lpszSubKey
, -1,
788 mp
->extview
.lpszSubKey
, len
);
789 mp
->isUnicode
= FALSE
;
790 return create_mru_list(mp
);
793 /**************************************************************************
794 * CreateMRUListW [COMCTL32.400]
796 * See CreateMRUListA.
798 HANDLE WINAPI
CreateMRUListW (const MRUINFOW
*infoW
)
800 return CreateMRUListLazyW(infoW
, 0, 0, 0);
803 /**************************************************************************
804 * CreateMRUListA [COMCTL32.151]
806 * Creates a most-recently-used list.
809 * lpcml [I] ptr to CREATEMRULIST structure.
812 * Handle to MRU list.
814 HANDLE WINAPI
CreateMRUListA (const MRUINFOA
*lpcml
)
816 return CreateMRUListLazyA (lpcml
, 0, 0, 0);
820 /**************************************************************************
821 * EnumMRUListW [COMCTL32.403]
823 * Enumerate item in a most-recently-used list
826 * hList [I] list handle
827 * nItemPos [I] item position to enumerate
828 * lpBuffer [O] buffer to receive item
829 * nBufferSize [I] size of buffer
832 * For binary lists specifies how many bytes were copied to buffer, for
833 * string lists specifies full length of string. Enumerating past the end
834 * of list returns -1.
835 * If lpBuffer == NULL or nItemPos is -ve return value is no. of items in
838 INT WINAPI
EnumMRUListW (HANDLE hList
, INT nItemPos
, LPVOID lpBuffer
,
841 const WINEMRULIST
*mp
= hList
;
842 const WINEMRUITEM
*witem
;
843 INT desired
, datasize
;
846 if ((nItemPos
< 0) || !lpBuffer
) return mp
->cursize
;
847 if (nItemPos
>= mp
->cursize
) return -1;
848 desired
= mp
->realMRU
[nItemPos
];
850 TRACE("nItemPos=%d, desired=%d\n", nItemPos
, desired
);
851 witem
= mp
->array
[desired
];
852 datasize
= min( witem
->size
, nBufferSize
);
853 memcpy( lpBuffer
, &witem
->datastart
, datasize
);
854 TRACE("(%p, %d, %p, %d): returning len=%d\n",
855 hList
, nItemPos
, lpBuffer
, nBufferSize
, datasize
);
859 /**************************************************************************
860 * EnumMRUListA [COMCTL32.154]
864 INT WINAPI
EnumMRUListA (HANDLE hList
, INT nItemPos
, LPVOID lpBuffer
,
867 const WINEMRULIST
*mp
= hList
;
869 INT desired
, datasize
;
873 if ((nItemPos
< 0) || !lpBuffer
) return mp
->cursize
;
874 if (nItemPos
>= mp
->cursize
) return -1;
875 desired
= mp
->realMRU
[nItemPos
];
877 TRACE("nItemPos=%d, desired=%d\n", nItemPos
, desired
);
878 witem
= mp
->array
[desired
];
879 if(mp
->extview
.fFlags
& MRU_BINARY
) {
880 datasize
= min( witem
->size
, nBufferSize
);
881 memcpy( lpBuffer
, &witem
->datastart
, datasize
);
883 lenA
= WideCharToMultiByte(CP_ACP
, 0, (LPWSTR
)&witem
->datastart
, -1,
884 NULL
, 0, NULL
, NULL
);
885 datasize
= min( lenA
, nBufferSize
);
886 WideCharToMultiByte(CP_ACP
, 0, (LPWSTR
)&witem
->datastart
, -1,
887 lpBuffer
, datasize
, NULL
, NULL
);
888 ((char *)lpBuffer
)[ datasize
- 1 ] = '\0';
891 TRACE("(%p, %d, %p, %d): returning len=%d\n",
892 hList
, nItemPos
, lpBuffer
, nBufferSize
, datasize
);
896 /**************************************************************************
897 * Str_GetPtrWtoA [internal]
899 * Converts a unicode string into a multi byte string
902 * lpSrc [I] Pointer to the unicode source string
903 * lpDest [O] Pointer to caller supplied storage for the multi byte string
904 * nMaxLen [I] Size, in bytes, of the destination buffer
907 * Length, in bytes, of the converted string.
910 INT
Str_GetPtrWtoA (LPCWSTR lpSrc
, LPSTR lpDest
, INT nMaxLen
)
914 TRACE("(%s %p %d)\n", debugstr_w(lpSrc
), lpDest
, nMaxLen
);
916 if (!lpDest
&& lpSrc
)
917 return WideCharToMultiByte(CP_ACP
, 0, lpSrc
, -1, 0, 0, NULL
, NULL
);
927 len
= WideCharToMultiByte(CP_ACP
, 0, lpSrc
, -1, 0, 0, NULL
, NULL
);
931 WideCharToMultiByte(CP_ACP
, 0, lpSrc
, -1, lpDest
, len
, NULL
, NULL
);
937 /**************************************************************************
938 * Str_GetPtrAtoW [internal]
940 * Converts a multibyte string into a unicode string
943 * lpSrc [I] Pointer to the multibyte source string
944 * lpDest [O] Pointer to caller supplied storage for the unicode string
945 * nMaxLen [I] Size, in characters, of the destination buffer
948 * Length, in characters, of the converted string.
951 INT
Str_GetPtrAtoW (LPCSTR lpSrc
, LPWSTR lpDest
, INT nMaxLen
)
955 TRACE("(%s %p %d)\n", debugstr_a(lpSrc
), lpDest
, nMaxLen
);
957 if (!lpDest
&& lpSrc
)
958 return MultiByteToWideChar(CP_ACP
, 0, lpSrc
, -1, 0, 0);
968 len
= MultiByteToWideChar(CP_ACP
, 0, lpSrc
, -1, 0, 0);
972 MultiByteToWideChar(CP_ACP
, 0, lpSrc
, -1, lpDest
, len
);
979 /**************************************************************************
980 * Str_SetPtrAtoW [internal]
982 * Converts a multi byte string to a unicode string.
983 * If the pointer to the destination buffer is NULL a buffer is allocated.
984 * If the destination buffer is too small to keep the converted multi byte
985 * string the destination buffer is reallocated. If the source pointer is
986 * NULL, the destination buffer is freed.
989 * lppDest [I/O] pointer to a pointer to the destination buffer
990 * lpSrc [I] pointer to a multi byte string
993 * TRUE: conversion successful
996 BOOL
Str_SetPtrAtoW (LPWSTR
*lppDest
, LPCSTR lpSrc
)
998 TRACE("(%p %s)\n", lppDest
, lpSrc
);
1001 INT len
= MultiByteToWideChar(CP_ACP
,0,lpSrc
,-1,NULL
,0);
1002 LPWSTR ptr
= ReAlloc (*lppDest
, len
*sizeof(WCHAR
));
1006 MultiByteToWideChar(CP_ACP
,0,lpSrc
,-1,ptr
,len
);
1017 /**************************************************************************
1018 * Str_SetPtrWtoA [internal]
1020 * Converts a unicode string to a multi byte string.
1021 * If the pointer to the destination buffer is NULL a buffer is allocated.
1022 * If the destination buffer is too small to keep the converted wide
1023 * string the destination buffer is reallocated. If the source pointer is
1024 * NULL, the destination buffer is freed.
1027 * lppDest [I/O] pointer to a pointer to the destination buffer
1028 * lpSrc [I] pointer to a wide string
1031 * TRUE: conversion successful
1034 BOOL
Str_SetPtrWtoA (LPSTR
*lppDest
, LPCWSTR lpSrc
)
1036 TRACE("(%p %s)\n", lppDest
, debugstr_w(lpSrc
));
1039 INT len
= WideCharToMultiByte(CP_ACP
,0,lpSrc
,-1,NULL
,0,NULL
,FALSE
);
1040 LPSTR ptr
= ReAlloc (*lppDest
, len
*sizeof(CHAR
));
1044 WideCharToMultiByte(CP_ACP
,0,lpSrc
,-1,ptr
,len
,NULL
,FALSE
);
1056 /**************************************************************************
1057 * Notification functions
1060 typedef struct tagNOTIFYDATA
1068 } NOTIFYDATA
, *LPNOTIFYDATA
;
1071 /**************************************************************************
1072 * DoNotify [Internal]
1075 static LRESULT
DoNotify (const NOTIFYDATA
*lpNotify
, UINT uCode
, LPNMHDR lpHdr
)
1078 LPNMHDR lpNmh
= NULL
;
1081 TRACE("(%p %p %d %p 0x%08x)\n",
1082 lpNotify
->hwndFrom
, lpNotify
->hwndTo
, uCode
, lpHdr
,
1083 lpNotify
->dwParam5
);
1085 if (!lpNotify
->hwndTo
)
1088 if (lpNotify
->hwndFrom
== (HWND
)-1) {
1090 idFrom
= lpHdr
->idFrom
;
1093 if (lpNotify
->hwndFrom
)
1094 idFrom
= GetDlgCtrlID (lpNotify
->hwndFrom
);
1096 lpNmh
= (lpHdr
) ? lpHdr
: &nmhdr
;
1098 lpNmh
->hwndFrom
= lpNotify
->hwndFrom
;
1099 lpNmh
->idFrom
= idFrom
;
1100 lpNmh
->code
= uCode
;
1103 return SendMessageW (lpNotify
->hwndTo
, WM_NOTIFY
, idFrom
, (LPARAM
)lpNmh
);
1107 /**************************************************************************
1108 * SendNotify [COMCTL32.341]
1110 * Sends a WM_NOTIFY message to the specified window.
1113 * hwndTo [I] Window to receive the message
1114 * hwndFrom [I] Window that the message is from (see notes)
1115 * uCode [I] Notification code
1116 * lpHdr [I] The NMHDR and any additional information to send or NULL
1119 * Success: return value from notification
1123 * If hwndFrom is -1 then the identifier of the control sending the
1124 * message is taken from the NMHDR structure.
1125 * If hwndFrom is not -1 then lpHdr can be NULL.
1127 LRESULT WINAPI
SendNotify (HWND hwndTo
, HWND hwndFrom
, UINT uCode
, LPNMHDR lpHdr
)
1131 TRACE("(%p %p %d %p)\n",
1132 hwndTo
, hwndFrom
, uCode
, lpHdr
);
1134 notify
.hwndFrom
= hwndFrom
;
1135 notify
.hwndTo
= hwndTo
;
1136 notify
.dwParam5
= 0;
1137 notify
.dwParam6
= 0;
1139 return DoNotify (¬ify
, uCode
, lpHdr
);
1143 /**************************************************************************
1144 * SendNotifyEx [COMCTL32.342]
1146 * Sends a WM_NOTIFY message to the specified window.
1149 * hwndFrom [I] Window to receive the message
1150 * hwndTo [I] Window that the message is from
1151 * uCode [I] Notification code
1152 * lpHdr [I] The NMHDR and any additional information to send or NULL
1153 * dwParam5 [I] Unknown
1156 * Success: return value from notification
1160 * If hwndFrom is -1 then the identifier of the control sending the
1161 * message is taken from the NMHDR structure.
1162 * If hwndFrom is not -1 then lpHdr can be NULL.
1164 LRESULT WINAPI
SendNotifyEx (HWND hwndTo
, HWND hwndFrom
, UINT uCode
,
1165 LPNMHDR lpHdr
, DWORD dwParam5
)
1170 TRACE("(%p %p %d %p 0x%08x)\n",
1171 hwndFrom
, hwndTo
, uCode
, lpHdr
, dwParam5
);
1173 hwndNotify
= hwndTo
;
1175 if (IsWindow (hwndFrom
)) {
1176 hwndNotify
= GetParent (hwndFrom
);
1182 notify
.hwndFrom
= hwndFrom
;
1183 notify
.hwndTo
= hwndNotify
;
1184 notify
.dwParam5
= dwParam5
;
1185 notify
.dwParam6
= 0;
1187 return DoNotify (¬ify
, uCode
, lpHdr
);