ShellEntry Struct Reference

shell file/directory entry More...

#include <shellfs.h>

Inheritance diagram for ShellEntry:

Collaboration diagram for ShellEntry:

Public Member Functions
	ShellEntry (Entry *parent, LPITEMIDLIST shell_path)
	ShellEntry (Entry *parent, const ShellPath &shell_path)
virtual bool	get_path (PTSTR path, size_t path_count) const
virtual ShellPath	create_absolute_pidl () const
virtual HRESULT	GetUIObjectOf (HWND hWnd, REFIID riid, LPVOID *ppvOut)
virtual BOOL	launch_entry (HWND hwnd, UINT nCmdShow=SW_SHOWNORMAL)
virtual HRESULT	do_context_menu (HWND hwnd, const POINT &pptScreen, CtxMenuInterfaces &cm_ifs)
virtual ShellFolder	get_shell_folder () const
IShellFolder *	get_parent_folder () const
Public Member Functions inherited from Entry
virtual	~Entry ()
void	free_subentries ()
void	read_directory_base (SORT_ORDER sortOrder=SORT_NAME, int scan_flags=0)
Entry *	read_tree (const void *path, SORT_ORDER sortOrder=SORT_NAME, int scan_flags=0)
void	sort_directory (SORT_ORDER sortOrder)
void	smart_scan (SORT_ORDER sortOrder=SORT_NAME, int scan_flags=0)
int	extract_icon (ICONCACHE_FLAGS flags=ICF_NORMAL)
int	safe_extract_icon (ICONCACHE_FLAGS flags=ICF_NORMAL)
virtual void	read_directory (int scan_flags=0)
virtual const void *	get_next_path_component (const void *) const
virtual Entry *	find_entry (const void *)
virtual bool	get_path (PTSTR path, size_t path_count) const =0
virtual ShellPath	create_absolute_pidl () const
virtual HRESULT	GetUIObjectOf (HWND hWnd, REFIID riid, LPVOID *ppvOut)
virtual ShellFolder	get_shell_folder () const
virtual BOOL	launch_entry (HWND hwnd, UINT nCmdShow=SW_SHOWNORMAL)
virtual HRESULT	do_context_menu (HWND hwnd, const POINT &pos, CtxMenuInterfaces &cm_ifs)

Public Attributes
ShellPath	_pidl
Public Attributes inherited from Entry
Entry *	_next
Entry *	_down
Entry *	_up
bool	_expanded
bool	_scanned
int	_level
WIN32_FIND_DATA	_data
SFGAOF	_shell_attribs
LPTSTR	_display_name
LPTSTR	_type_name
LPTSTR	_content
ENTRY_TYPE	_etype
int	_icon_id
BY_HANDLE_FILE_INFORMATION	_bhfi
bool	_bhfi_valid

Protected Member Functions
	ShellEntry (LPITEMIDLIST shell_path)
	ShellEntry (const ShellPath &shell_path)
Protected Member Functions inherited from Entry
	Entry (ENTRY_TYPE etype)
	Entry (Entry *parent, ENTRY_TYPE etype)
	Entry (const Entry &)
bool	get_path_base (PTSTR path, size_t path_count, ENTRY_TYPE etype) const

Detailed Description

shell file/directory entry

Definition at line 30 of file shellfs.h.

Constructor & Destructor Documentation

ShellEntry() [1/4]

ShellEntry::ShellEntry ( Entry *  parent, LPITEMIDLIST  shell_path  )

inline

Definition at line 32 of file shellfs.h.

: Entry(parent, ET_SHELL), _pidl(shell_path) {}

ShellEntry() [2/4]

ShellEntry::ShellEntry ( Entry *  parent, const ShellPath &  shell_path  )

inline

Definition at line 33 of file shellfs.h.

: Entry(parent, ET_SHELL), _pidl(shell_path) {}

ShellEntry() [3/4]

ShellEntry::ShellEntry ( LPITEMIDLIST  shell_path )

inlineprotected

Definition at line 47 of file shellfs.h.

: Entry(ET_SHELL), _pidl(shell_path) {}

ShellEntry() [4/4]

ShellEntry::ShellEntry ( const ShellPath &  shell_path )

inlineprotected

Definition at line 48 of file shellfs.h.

: Entry(ET_SHELL), _pidl(shell_path) {}

Member Function Documentation

create_absolute_pidl()

ShellPath ShellEntry::create_absolute_pidl ( ) const

virtual

Reimplemented from Entry.

Definition at line 114 of file shellfs.cpp.

{
    CONTEXT("ShellEntry::create_absolute_pidl()");
 
    if (_up)
    {
        if (_up->_etype == ET_SHELL) {
            ShellDirectory* dir = static_cast<ShellDirectory*>(_up);
 
            if (dir->_pidl->mkid.cb)    // Caching of absolute PIDLs could enhance performance.
                return _pidl.create_absolute_pidl(dir->create_absolute_pidl());
        } else
            return _pidl.create_absolute_pidl(_up->create_absolute_pidl());
    }
    return _pidl;
}

Referenced by get_path(), ShellBrowser::jump_to(), and launch_entry().

do_context_menu()

HRESULT ShellEntry::do_context_menu ( HWND  hwnd, const POINT &  pptScreen, CtxMenuInterfaces &  cm_ifs  )

virtual

Reimplemented from Entry.

Definition at line 218 of file shellfs.cpp.

{
    ShellDirectory* dir = static_cast<ShellDirectory*>(_up);
 
    ShellFolder folder = dir? dir->_folder: GetDesktopFolder();
    LPCITEMIDLIST pidl = _pidl;
 
    return ShellFolderContextMenu(folder, hwnd, 1, &pidl, pptScreen.x, pptScreen.y, cm_ifs);
}

get_parent_folder()

IShellFolder * ShellEntry::get_parent_folder ( ) const

inline

Definition at line 120 of file shellfs.h.

{
    if (_up)
        return static_cast<ShellDirectory*>(_up)->_folder;
    else
        return GetDesktopFolder();
}

Referenced by ShellDirectory::get_path(), get_shell_folder(), and GetUIObjectOf().

get_path()

bool ShellEntry::get_path ( PTSTR  path, size_t  path_count  ) const

virtual

Implements Entry.

Reimplemented in ShellDirectory.

Definition at line 133 of file shellfs.cpp.

{
    if (!path || path_count==0)
        return false;
/*
    path[0] = TEXT('\0');
 
    if (FAILED(path_from_pidl(get_parent_folder(), &*_pidl, path, path_count)))
        return false;
*/
    FileSysShellPath fs_path(create_absolute_pidl());
    LPCTSTR ret = fs_path;
 
    if (ret) {
        lstrcpyn(path, ret, path_count);
        return true;
    } else
        return false;
}

get_shell_folder()

ShellFolder ShellEntry::get_shell_folder ( ) const

virtual

Reimplemented from Entry.

Reimplemented in ShellDirectory.

Definition at line 242 of file shellfs.cpp.

{
    return get_parent_folder();
}

GetUIObjectOf()

HRESULT ShellEntry::GetUIObjectOf ( HWND  hWnd, REFIID  riid, LPVOID *  ppvOut  )

virtual

Reimplemented from Entry.

Definition at line 229 of file shellfs.cpp.

{
    LPCITEMIDLIST pidl = _pidl;
 
    return get_parent_folder()->GetUIObjectOf(hWnd, 1, &pidl, riid, NULL, ppvOut);
}

launch_entry()

BOOL ShellEntry::launch_entry ( HWND  hwnd, UINT  nCmdShow = SW_SHOWNORMAL  )

virtual

Reimplemented from Entry.

Definition at line 186 of file shellfs.cpp.

{
    CONTEXT("ShellEntry::launch_entry()");
 
    SHELLEXECUTEINFO shexinfo;
 
    shexinfo.cbSize = sizeof(SHELLEXECUTEINFO);
    shexinfo.fMask = SEE_MASK_INVOKEIDLIST; // SEE_MASK_IDLIST is also possible.
    shexinfo.hwnd = hwnd;
    shexinfo.lpVerb = NULL;
    shexinfo.lpFile = NULL;
    shexinfo.lpParameters = NULL;
    shexinfo.lpDirectory = NULL;
    shexinfo.nShow = nCmdShow;
 
    ShellPath shell_path = create_absolute_pidl();
    shexinfo.lpIDList = &*shell_path;
 
     // add PIDL to the recent file list
    SHAddToRecentDocs(SHARD_PIDL, shexinfo.lpIDList);
 
    BOOL ret = TRUE;
 
    if (!ShellExecuteEx(&shexinfo)) {
        display_error(hwnd, GetLastError());
        ret = FALSE;
    }
 
    return ret;
}

Member Data Documentation

_pidl

ShellPath ShellEntry::_pidl

Definition at line 44 of file shellfs.h.

Referenced by create_absolute_pidl(), do_context_menu(), ShellDirectory::find_entry(), ShellDirectory::get_path(), GetUIObjectOf(), and BookmarkList::import_IE_favorites().

---

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

• modules/rosapps/applications/explorer-old/shell/shellfs.h
• modules/rosapps/applications/explorer-old/shell/shellfs.cpp