Function Reference


_WinAPI_EnumMRUList

Enumerates the contents of the most recently used (MRU) list

#include <WinAPIReg.au3>
_WinAPI_EnumMRUList ( $hMRU, $iItem )

Parameters

$hMRU Handle of the MRU list, obtained when the list was created.
$iItem The item to return. If this value is (-1), the function returns the number of items in the MRU list.

Return Value

Success: The item requested in $iItem. If $iItem is (-1), the number of items in the MRU list.
Failure: 0 and sets the @error flag to non-zero.

See Also

Search EnumMRUListW in MSDN Library.

Example

#include <APIRegConstants.au3>
#include <ComboConstants.au3>
#include <GUIConstantsEx.au3>
#include <WinAPIReg.au3>

Local $hMRU = _WinAPI_CreateMRUList($HKEY_CURRENT_USER, 'Software\MyProg\MRU', 5)

; Create MRU list in the registry (only at first start example)
RegRead('HKCU\Software\MyProg\MRU', 'MRUList')
If @error Then
        For $i = 5 To 1 Step -1
                _WinAPI_AddMRUString($hMRU, 'String' & $i)
        Next
EndIf

GUICreate('Test ' & StringReplace(@ScriptName, '.au3', '()'), 320, 92)
Local $idCombo = GUICtrlCreateCombo(_WinAPI_EnumMRUList($hMRU, 0), 10, 20, 300, 21, $CBS_DROPDOWNLIST)
Local $iCount = _WinAPI_EnumMRUList($hMRU, -1)
Local $sData = ''
For $i = 1 To $iCount - 1
        $sData &= _WinAPI_EnumMRUList($hMRU, $i) & '|'
Next
GUICtrlSetData(-1, $sData)
Local $idButton = GUICtrlCreateButton('OK', 125, 58, 70, 23)
GUISetState(@SW_SHOW)

While 1
        Switch GUIGetMsg()
                Case $GUI_EVENT_CLOSE
                        ExitLoop
                Case $idButton
                        _WinAPI_AddMRUString($hMRU, GUICtrlRead($idCombo))
                        ExitLoop
        EndSwitch
WEnd

_WinAPI_FreeMRUList($hMRU)