Inheritance diagram for CMruNode:

[legend]

Collaboration diagram for CMruNode:

[legend]

Public Member Functions
	CMruNode ()

	CMruNode (CMruNode *pParent, UINT iSlot)

	~CMruNode () override

CMruNode *	GetParent ()

HRESULT	BindToSlot (UINT iSlot, IShellFolder **ppSF)

HRESULT	GetNode (BOOL bAdd, LPCITEMIDLIST pidl, CMruNode **pNewNode)

HRESULT	GetNodeSlot (UINT *pnNodeSlot)

HRESULT	SetNodeSlot (UINT nNodeSlot)

HRESULT	RemoveLeast (UINT *pnNodeSlot)

HRESULT	Clear (CMruPidlList *pList)

Public Member Functions inherited from CMruLongList
	CMruLongList ()

	~CMruLongList () override

Public Member Functions inherited from CMruBase
	CMruBase ()

virtual	~CMruBase ()

STDMETHODIMP	QueryInterface (REFIID riid, void **ppvObj) override

	STDMETHODIMP_ (ULONG) AddRef() override

	STDMETHODIMP_ (ULONG) Release() override

STDMETHODIMP	InitData (UINT cCapacity, UINT flags, HKEY hKey, LPCWSTR pszSubKey OPTIONAL, SLOTCOMPARE fnCompare OPTIONAL) override

STDMETHODIMP	AddData (LPCVOID pvData, DWORD cbData, UINT *piSlot) override

STDMETHODIMP	FindData (LPCVOID pvData, DWORD cbData, UINT *piSlot) override

STDMETHODIMP	GetData (UINT iSlot, LPVOID pvData, DWORD cbData) override

STDMETHODIMP	QueryInfo (UINT iSlot, UINT piGotSlot, DWORD pcbData) override

STDMETHODIMP	Delete (UINT iSlot) override

virtual BOOL	_IsEqual (const SLOTITEMDATA *pItem, LPCVOID pvData, UINT cbData) const

virtual DWORD	_DeleteValue (LPCWSTR pszValue)

virtual HRESULT	_InitSlots ()=0

virtual void	_SaveSlots ()=0

virtual UINT	_UpdateSlots (UINT iSlot)=0

virtual void	_SlotString (UINT iSlot, LPWSTR psz, DWORD cch)=0

virtual HRESULT	_GetSlot (UINT iSlot, UINT *puSlot)=0

virtual HRESULT	_RemoveSlot (UINT iSlot, UINT *puSlot)=0

Protected Member Functions
BOOL	_InitLate ()

BOOL	_IsEqual (SLOTITEMDATA *pItem, LPCVOID pvData, UINT cbData)

DWORD	_DeleteValue (LPCWSTR pszValue) override

HRESULT	_CreateNode (UINT iSlot, CMruNode **ppNewNode)

HRESULT	_AddPidl (UINT iSlot, LPCITEMIDLIST pidl)

HRESULT	_FindPidl (LPCITEMIDLIST pidl, UINT *piSlot)

HRESULT	_GetPidlSlot (LPCITEMIDLIST pidl, BOOL bAdd, UINT *piSlot)

virtual BOOL	_IsEqual (const SLOTITEMDATA *pItem, LPCVOID pvData, UINT cbData) const

Protected Member Functions inherited from CMruLongList
void	_ImportShortList ()

HRESULT	_InitSlots () override

void	_SaveSlots () override

UINT	_UpdateSlots (UINT iSlot) override

void	_SlotString (UINT iSlot, LPWSTR psz, DWORD cch) override

HRESULT	_GetSlot (UINT iSlot, UINT *puSlot) override

HRESULT	_RemoveSlot (UINT iSlot, UINT *puSlot) override

Protected Member Functions inherited from CMruBase
HRESULT	_LoadItem (UINT iSlot)

HRESULT	_AddItem (UINT iSlot, LPCVOID pvData, DWORD cbData)

HRESULT	_GetItem (UINT iSlot, SLOTITEMDATA **ppItem)

void	_DeleteItem (UINT iSlot)

HRESULT	_GetSlotItem (UINT iSlot, SLOTITEMDATA **ppItem)

void	_CheckUsedSlots ()

HRESULT	_UseEmptySlot (UINT *piSlot)

Protected Attributes
UINT	m_iSlot = 0

CMruNode *	m_pParent = NULL

IShellFolder *	m_pShellFolder = NULL

Protected Attributes inherited from CMruLongList
UINT *	m_puSlotData = NULL

Protected Attributes inherited from CMruBase
LONG	m_cRefs = 1

DWORD	m_dwFlags = 0

BOOL	m_bNeedSave = FALSE

BOOL	m_bChecked = FALSE

HKEY	m_hKey = NULL

DWORD	m_cSlotRooms = 0

DWORD	m_cSlots = 0

SLOTCOMPARE	m_fnCompare = NULL

SLOTITEMDATA *	m_pSlots = NULL

Additional Inherited Members
Static Public Member Functions inherited from CMruBase
static void *	operator new (size_t size)

static void	operator delete (void *ptr)

Detailed Description

Definition at line 728 of file mrulist.cpp.

Constructor & Destructor Documentation

◆ CMruNode() [1/2]

CMruNode::CMruNode ( )

inline

Definition at line 747 of file mrulist.cpp.

747{ }

Referenced by _CreateNode().

◆ CMruNode() [2/2]

CMruNode::CMruNode	(	CMruNode *	pParent,
		UINT	iSlot
	)

Definition at line 762 of file mrulist.cpp.

{
    m_iSlot = iSlot;
    m_pParent = pParent;
    pParent->AddRef();
}

◆ ~CMruNode()

CMruNode::~CMruNode ( )

override

Definition at line 769 of file mrulist.cpp.

{
    if (m_pParent)
    {
        m_pParent->Release();
        m_pParent = NULL;
    }
 
    if (m_pShellFolder)
    {
        m_pShellFolder->Release();
        m_pShellFolder = NULL;
    }
}

Member Function Documentation

◆ _AddPidl()

HRESULT CMruNode::_AddPidl	(	UINT	iSlot,
		LPCITEMIDLIST	pidl
	)

protected

Definition at line 898 of file mrulist.cpp.

{
    return CMruBase::_AddItem(iSlot, pidl, sizeof(WORD) + pidl->mkid.cb);
}

Referenced by _GetPidlSlot().

◆ _CreateNode()

HRESULT CMruNode::_CreateNode	(	UINT	iSlot,
		CMruNode **	ppNewNode
	)

protected

Definition at line 791 of file mrulist.cpp.

{
    CMruNode *pNewNode = new CMruNode(this, iSlot);
    if (!pNewNode)
        return E_OUTOFMEMORY;
 
    WCHAR szSubKey[12];
    _SlotString(iSlot, szSubKey, _countof(szSubKey));
 
    HRESULT hr = pNewNode->InitData(m_cSlotRooms, 0, m_hKey, szSubKey, NULL);
    if (FAILED(hr))
        pNewNode->Release();
    else
        *ppNewNode = pNewNode;
 
    return hr;
}

Referenced by Clear(), GetNode(), and RemoveLeast().

◆ _DeleteValue()

DWORD CMruNode::_DeleteValue ( LPCWSTR pszValue )

overrideprotectedvirtual

Reimplemented from CMruBase.

Definition at line 903 of file mrulist.cpp.

{
    CMruBase::_DeleteValue(pszValue);
    return SHDeleteKeyW(m_hKey, pszValue);
}

◆ _FindPidl()

HRESULT CMruNode::_FindPidl	(	LPCITEMIDLIST	pidl,
		UINT *	piSlot
	)

protected

Definition at line 909 of file mrulist.cpp.

{
    return FindData(pidl, sizeof(WORD) + pidl->mkid.cb, piSlot);
}

Referenced by _GetPidlSlot().

◆ _GetPidlSlot()

HRESULT CMruNode::_GetPidlSlot	(	LPCITEMIDLIST	pidl,
		BOOL	bAdd,
		UINT *	piSlot
	)

protected

Definition at line 914 of file mrulist.cpp.

{
    LPITEMIDLIST pidlFirst = ILCloneFirst(pidl);
    if (!pidlFirst)
        return E_OUTOFMEMORY;
 
    UINT iSlot;
    HRESULT hr = _FindPidl(pidlFirst, &iSlot);
    if (SUCCEEDED(hr))
    {
        *piSlot = _UpdateSlots(iSlot);
        hr = S_OK;
    }
    else if (bAdd)
    {
        *piSlot = _UpdateSlots(m_cSlots);
        hr = _AddPidl(*piSlot, pidlFirst);
    }
 
    ILFree(pidlFirst);
    return hr;
}

Referenced by GetNode().

◆ _InitLate()

BOOL CMruNode::_InitLate ( )

protected

Definition at line 861 of file mrulist.cpp.

{
    if (!m_pShellFolder)
    {
        if (m_pParent)
            m_pParent->BindToSlot(m_iSlot, &m_pShellFolder);
        else
            SHGetDesktopFolder(&m_pShellFolder);
    }
    return !!m_pShellFolder;
}

Referenced by GetNode().

◆ _IsEqual() [1/2]

BOOL CMruBase::_IsEqual	(	const SLOTITEMDATA *	pItem,
		LPCVOID	pvData,
		UINT	cbData
	)		const

protectedvirtual

Reimplemented from CMruBase.

Definition at line 111 of file mrulist.cpp.

{
    if (m_fnCompare)
        return m_fnCompare(pvData, pItem->pvData, cbData) == 0;
 
    switch (m_dwFlags & COMPARE_BY_MASK)
    {
        case COMPARE_BY_MEMCMP:
            if (pItem->cbData != cbData)
                return FALSE;
            return memcmp(pvData, pItem->pvData, cbData) == 0;
 
        case COMPARE_BY_STRCMPIW:
            return StrCmpIW((LPCWSTR)pvData, (LPCWSTR)pItem->pvData) == 0;
 
        case COMPARE_BY_STRCMPW:
            return StrCmpW((LPCWSTR)pvData, (LPCWSTR)pItem->pvData) == 0;
 
        case COMPARE_BY_IEILISEQUAL:
            return IEILIsEqual((LPCITEMIDLIST)pvData, (LPCITEMIDLIST)pItem->pvData, FALSE);
 
        default:
            ERR("0x%08X\n", m_dwFlags);
            return FALSE;
    }
}

◆ _IsEqual() [2/2]

BOOL CMruNode::_IsEqual	(	SLOTITEMDATA *	pItem,
		LPCVOID	pvData,
		UINT	cbData
	)

protected

Definition at line 873 of file mrulist.cpp.

{
    return m_pShellFolder->CompareIDs(0x10000000,
                                      (LPITEMIDLIST)pItem->pvData,
                                      (LPCITEMIDLIST)pvData) == 0;
}

◆ BindToSlot()

HRESULT CMruNode::BindToSlot	(	UINT	iSlot,
		IShellFolder **	ppSF
	)

Definition at line 848 of file mrulist.cpp.

{
    SLOTITEMDATA *pItem;
    HRESULT hr = _GetSlotItem(iSlot, &pItem);
    if (FAILED(hr))
        return hr;
 
    return m_pShellFolder->BindToObject((LPITEMIDLIST)pItem->pvData,
                                        NULL,
                                        IID_IShellFolder,
                                        (void **)ppSF);
}

Referenced by _InitLate().

◆ Clear()

HRESULT CMruNode::Clear ( CMruPidlList * pList )

Definition at line 1267 of file mrulist.cpp.

{
    UINT uSlot, nNodeSlot;
    HRESULT hr;
 
    while (SUCCEEDED(_GetSlot(0, &uSlot)))
    {
        CMruNode *pNode;
        hr = _CreateNode(uSlot, &pNode);
        if (SUCCEEDED(hr))
        {
            hr = pNode->GetNodeSlot(&nNodeSlot);
            if (SUCCEEDED(hr))
                pList->EmptyNodeSlot(nNodeSlot);
 
            pNode->Clear(pList);
            pNode->Release();
        }
        Delete(0);
    }
 
    return S_OK;
}

Referenced by Clear(), and CMruPidlList::PruneKids().

◆ GetNode()

HRESULT CMruNode::GetNode	(	BOOL	bAdd,
		LPCITEMIDLIST	pidl,
		CMruNode **	pNewNode
	)

Definition at line 809 of file mrulist.cpp.

{
    if (!pidl || !pidl->mkid.cb)
    {
        *ppNewNode = this;
        AddRef();
        return S_OK;
    }
 
    if (!_InitLate())
        return E_FAIL;
 
    UINT iSlot;
    HRESULT hr = _GetPidlSlot(pidl, bAdd, &iSlot);
    if (FAILED(hr))
    {
        if (!bAdd)
        {
            *ppNewNode = this;
            AddRef();
            return S_FALSE;
        }
        return hr;
    }
 
    CMruNode *pNewNode;
    hr = _CreateNode(iSlot, &pNewNode);
    if (SUCCEEDED(hr))
    {
        _SaveSlots();
 
        LPCITEMIDLIST pidl2 = (LPCITEMIDLIST)((LPBYTE)pidl + pidl->mkid.cb);
        pNewNode->GetNode(bAdd, pidl2, ppNewNode);
        pNewNode->Release();
    }
 
    return hr;
}

Referenced by GetNode(), CMruPidlList::PruneKids(), CMruPidlList::QueryPidl(), and CMruPidlList::UsePidl().

◆ GetNodeSlot()

HRESULT CMruNode::GetNodeSlot ( UINT * pnNodeSlot )

Definition at line 880 of file mrulist.cpp.

{
    DWORD dwData, cbData = sizeof(dwData);
    DWORD error = SHGetValueW(m_hKey, NULL, L"NodeSlot", NULL, &dwData, (pnNodeSlot ? &cbData : NULL));
    if (error != ERROR_SUCCESS)
        return E_FAIL;
    *pnNodeSlot = (UINT)dwData;
    return S_OK;
}

Referenced by Clear(), CMruPidlList::QueryPidl(), RemoveLeast(), and CMruPidlList::UsePidl().

◆ GetParent()

CMruNode * CMruNode::GetParent ( )

Definition at line 784 of file mrulist.cpp.

{
    if (m_pParent)
        m_pParent->AddRef();
    return m_pParent;
}

Referenced by CMruPidlList::QueryPidl().

◆ RemoveLeast()

HRESULT CMruNode::RemoveLeast ( UINT * pnNodeSlot )

Definition at line 937 of file mrulist.cpp.

{
    if (!m_cSlots)
    {
        GetNodeSlot(pnNodeSlot);
        return S_FALSE;
    }
 
    UINT uSlot;
    HRESULT hr = _GetSlot(m_cSlots - 1, &uSlot);
    if (FAILED(hr))
        return hr;
 
    CMruNode *pNode;
    hr = _CreateNode(uSlot, &pNode);
    if (SUCCEEDED(hr))
    {
        hr = pNode->RemoveLeast(pnNodeSlot);
        pNode->Release();
    }
 
    if (hr == S_FALSE)
    {
        Delete(m_cSlots - 1);
        if (m_cSlots || SUCCEEDED(GetNodeSlot(0)))
            return S_OK;
    }
 
    return hr;
}

Referenced by CMruPidlList::GetEmptySlot(), and RemoveLeast().

◆ SetNodeSlot()

HRESULT CMruNode::SetNodeSlot ( UINT nNodeSlot )

Definition at line 890 of file mrulist.cpp.

{
    DWORD dwData = nNodeSlot;
    if (SHSetValueW(m_hKey, NULL, L"NodeSlot", REG_DWORD, &dwData, sizeof(dwData)) != ERROR_SUCCESS)
        return E_FAIL;
    return S_OK;
}

Referenced by CMruPidlList::UsePidl().

Member Data Documentation

◆ m_iSlot

UINT CMruNode::m_iSlot = 0

protected

Definition at line 732 of file mrulist.cpp.

Referenced by _InitLate(), and CMruNode().

◆ m_pParent

CMruNode* CMruNode::m_pParent = NULL

protected

Definition at line 733 of file mrulist.cpp.

Referenced by _InitLate(), CMruNode(), GetParent(), and ~CMruNode().

◆ m_pShellFolder

IShellFolder* CMruNode::m_pShellFolder = NULL

protected

Definition at line 734 of file mrulist.cpp.

Referenced by _InitLate(), _IsEqual(), BindToSlot(), and ~CMruNode().

The documentation for this class was generated from the following file:

dll/win32/shdocvw/mrulist.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CMruNode() [1/2]

◆ CMruNode() [2/2]

◆ ~CMruNode()

Member Function Documentation

◆ _AddPidl()

◆ _CreateNode()

◆ _DeleteValue()

◆ _FindPidl()

◆ _GetPidlSlot()

◆ _InitLate()

◆ _IsEqual() [1/2]

◆ _IsEqual() [2/2]

◆ BindToSlot()

◆ Clear()

◆ GetNode()

◆ GetNodeSlot()

◆ GetParent()

◆ RemoveLeast()

◆ SetNodeSlot()

Member Data Documentation

◆ m_iSlot

◆ m_pParent

◆ m_pShellFolder