A wrapper class for ITEMIDLIST

• Download demo project - 8 Kb
• Download source - 6 Kb

Introduction

This is a class helps you manage ITEMIDLIST easier.

The 
  CItemIDList

class holds a pointer to a ITEMIDLIST structure (the pointer is in CItemIDList::m_pidl). It also has public static member functions which you can use as global functions.(Version 2.0)

Constructors

CItemIDList(LPCTSTR pcszPath);	Construct with a path string.
CItemIDList(LPITEMIDLIST pidl);	Construct with LPITEMIDLIST.(Copy it,and free on destruct)
CItemIDList(CItemIDList& iidl);	Construct with another class object.
CItemIDList(void);	Construct class instance with m_pidl empty.

Member functions

int GetIconIndex(void) const;	Get folder item's icon index in system image list.
BOOL GetDisplayName(LPTSTR pszBuf,DWORD dwFlags=SHGDN_NORMAL) const;	Retrieve pidl's dislpay name.
CItemIDList Duplicate(UINT nCount=-1) const;	Copy a pidl due to the count number.
inline BOOL IsEmpty(void) const;	Whether m_pidl is NULL.
CItemIDList GetAt(UINT nIndex) const;	Return a relative pidl at specified index.
BOOL Create(LPITEMIDLIST pidlf);	Create from a LPITEMIDLIST.
inline UINT GetCount(void) const;	Get pidl count.
inline UINT GetSize(void) const;	Get pidl's size,in byte.
inline void Empty(void);	Free m_pidl and set to NULL.
void GetPath(LPTSTR pszPath) const;	Retrieve full path.(only available for full-quality pidl)
inline HRESULT GetUIObjectOf(REFIID riid,LPVOID* ppOut,HWND hWnd=NULL);	Retrieve other shell interface.Same as IShellFolder::GetUIObjectOf.
inline void Split(LPSHELLFOLDER& lpsf,CItemIDList& ciid) const;	Get IShellFolder interface and the tail pidl cell from a full-quality pidl.
CItemIDList GetLastPidl(void) const;	Retrieve the tail pidl cell.
void GetToolTipInfo(LPTSTR pszToolTip,UINT cbSize) const;	Retrieve the tooltip info of the m_pidl.
void Attach(LPITEMIDLIST pidl);	Attach a pidl.
LPITEMIDLIST Detach(void);	Detach a pidl.

Operators

CItemIDList operator+(CItemIDList& piidl);	Concat two pidls.
operator LPITEMIDLIST(void) const;	Get m_pidl.
operator LPCITEMIDLIST(void) const;	Get m_pidl convert to LPCITEMIDLIST.
const CItemIDList& operator=(CItemIDList& ciidl1);	Copy from another class instance.
const CItemIDList& operator=(LPITEMIDLIST pidl);	Copy from a LPITEMIDLIST.
operator+=(CItemIDList& ciidl);	Add a new pidl to m_pidl's tail.
BOOL operator==(CItemIDList& ciidl);	Query whether two pidl's name is same.
CItemIDList operator[](UINT nIndex);	Return a relative pidl at specified index.(Same as CItemIDList::GetAt(UINT nIndex) )

Example

#include "ItemIDList.h"
#include <windows.h>
#include <iostream.h>

//Some test code...
void main()
{
	char szFile[MAX_PATH];
	ZeroMemory(szFile,MAX_PATH);

	OPENFILENAME info;
	ZeroMemory(&info,sizeof(info));

	info.lStructSize=sizeof(info);
	info.lpstrFile=szFile;
	info.hwndOwner=NULL;
	info.nMaxFile=MAX_PATH;

	if(GetOpenFileName(&info))
	{
		CItemIDList item(szFile),item2;
		char szName[MAX_PATH];
		item.GetDisplayName(szName);
		cout<<szName<<endl;

		item.GetToolTipInfo(szName,MAX_PATH);
		cout<<szName<<endl;

		item2=item;
		item2.GetPath(szName);
		cout<<szName<<endl;

		item2=item[item.GetCount()-1];
		item2.GetDisplayName(szName);
		cout<<szName<<endl;

		item2=item.GetAt(0);
		item2.GetDisplayName(szName);
		cout<<szName<<endl;

		CItemIDList item3;
		item3=item.Duplicate(item.GetCount()-1);
		item3.GetPath(szName);
		cout<<szName<<endl;

		item3=item.Duplicate(item.GetCount()-1)+item2;
		item3.GetPath(szName);
		cout<<szName<<endl;
	}
}

Enjoy...