ShellFolder Struct Reference

IShellFolder smart pointer. More...

#include <shellclasses.h>

Inheritance diagram for ShellFolder:

Collaboration diagram for ShellFolder:

Public Types
typedef SIfacePtr< IShellFolder >	super

Public Member Functions
	ShellFolder ()
	ShellFolder (IShellFolder *p)
	ShellFolder (IShellFolder *parent, LPCITEMIDLIST pidl)
	ShellFolder (LPCITEMIDLIST pidl)
void	attach (IShellFolder *parent, LPCITEMIDLIST pidl)
String	get_name (LPCITEMIDLIST pidl, SHGDNF flags=SHGDN_NORMAL) const
Public Member Functions inherited from SIfacePtr< IShellFolder >
	SIfacePtr ()
	SIfacePtr (IShellFolder *p)
	SIfacePtr (IUnknown *unknown, REFIID riid)
	~SIfacePtr ()
IShellFolder *	operator-> ()
const IShellFolder *	operator-> () const
	operator IShellFolder * ()
IShellFolder **	operator& ()
bool	empty () const
SIfacePtr &	operator= (IShellFolder *p)
void	operator= (SIfacePtr const &o)
HRESULT	CreateInstance (REFIID clsid, REFIID riid)
HRESULT	QueryInterface (REFIID riid, I *p)
IShellFolder *	get ()
void	Free ()

Additional Inherited Members
Protected Member Functions inherited from SIfacePtr< IShellFolder >
	SIfacePtr (const SIfacePtr &o)
Protected Attributes inherited from SIfacePtr< IShellFolder >
IShellFolder *	_p

Detailed Description

IShellFolder smart pointer.

Definition at line 593 of file shellclasses.h.

Member Typedef Documentation

super

typedef SIfacePtr<IShellFolder> ShellFolder::super

Definition at line 595 of file shellclasses.h.

Constructor & Destructor Documentation

ShellFolder() [1/4]

ShellFolder::ShellFolder

(

)

Definition at line 194 of file shellclasses.cpp.

{
    CONTEXT("ShellFolder::ShellFolder()");
 
    IShellFolder* desktop;
 
    CHECKERROR(SHGetDesktopFolder(&desktop));
 
    super::Attach(desktop);
    desktop->AddRef();
}

ShellFolder() [2/4]

ShellFolder::ShellFolder

(

IShellFolder *

p

)

Definition at line 206 of file shellclasses.cpp.

 :  super(p)
{
    CONTEXT("ShellFolder::ShellFolder(IShellFolder*)");
 
    p->AddRef();
}

ShellFolder() [3/4]

ShellFolder::ShellFolder	(	IShellFolder *	parent,
		LPCITEMIDLIST	pidl
	)

Definition at line 214 of file shellclasses.cpp.

{
    CONTEXT("ShellFolder::ShellFolder(IShellFolder*, LPCITEMIDLIST)");
 
    IShellFolder* ptr;
 
    if (!pidl)
        CHECKERROR(E_INVALIDARG);
 
    if (pidl && pidl->mkid.cb)
        CHECKERROR(parent->BindToObject(pidl, 0, IID_IShellFolder, (LPVOID*)&ptr));
    else
        ptr = parent;
 
    super::Attach(ptr);
    ptr->AddRef();
}

ShellFolder() [4/4]

ShellFolder::ShellFolder

(

LPCITEMIDLIST

pidl

)

Definition at line 232 of file shellclasses.cpp.

{
    CONTEXT("ShellFolder::ShellFolder(LPCITEMIDLIST)");
 
    IShellFolder* ptr;
    IShellFolder* parent = GetDesktopFolder();
 
    if (pidl && pidl->mkid.cb)
        CHECKERROR(parent->BindToObject(pidl, 0, IID_IShellFolder, (LPVOID*)&ptr));
    else
        ptr = parent;
 
    super::Attach(ptr);
    ptr->AddRef();
}

Member Function Documentation

attach()

void ShellFolder::attach	(	IShellFolder *	parent,
		LPCITEMIDLIST	pidl
	)

Definition at line 248 of file shellclasses.cpp.

{
    CONTEXT("ShellFolder::attach(IShellFolder*, LPCITEMIDLIST)");
 
    IShellFolder* ptr;
 
    if (pidl && pidl->mkid.cb)
        CHECKERROR(parent->BindToObject(pidl, 0, IID_IShellFolder, (LPVOID*)&ptr));
    else
        ptr = parent;
 
    super::Attach(ptr);
    ptr->AddRef();
}

get_name()

String ShellFolder::get_name	(	LPCITEMIDLIST	pidl,
		SHGDNF	flags = SHGDN_NORMAL
	)		const

Definition at line 320 of file shellclasses.cpp.

{
    CONTEXT("ShellFolder::get_name()");
 
    TCHAR buffer[MAX_PATH];
    StrRet strret;
 
    HRESULT hr = ((IShellFolder*)*const_cast<ShellFolder*>(this))->GetDisplayNameOf(pidl, flags, &strret);
 
    if (hr == S_OK)
        strret.GetString(pidl->mkid, buffer, COUNTOF(buffer));
    else {
        CHECKERROR(hr);
        *buffer = TEXT('\0');
    }
 
    return buffer;
}

Referenced by ShellBrowser::Init(), and ShellDirectory::ShellDirectory().

---

The documentation for this struct was generated from the following files:

• modules/rosapps/applications/explorer-old/utility/shellclasses.h
• modules/rosapps/applications/explorer-old/utility/shellclasses.cpp