Category

Development Platform
Home > SourceCode/Document > Windows Develop > Windows Kernel > View Code
isf.h
Package: shell.rar　[view]
Upload User: xhy777
Upload Date: 2007-02-14
Package Size: 24088k
Code Size: 8k
Category:

Windows Kernel

Development Platform:

Visual C++

isf.h：Code Content
  1. /*****************************************************************************
  2.     FILE: isf.h
  4.     DESCRIPTION:
  5.         This is a base class that implements the default behavior of IShellFolder.
  6. *****************************************************************************/
  8. #ifndef _DEFAULT_ISHELLFOLDER_H
  9. #define _DEFAULT_ISHELLFOLDER_H
  11. #include "cowsite.h"
  14. /*****************************************************************************
  15.     CLASS: CBaseFolder
  17.     DESCRIPTION:
  18.         The stuff that tracks the state of a folder.
  20.     The cBusy field tracks how many sub-objects have been created
  21.     (e.g., IEnumIDList) which still contain references to this
  22.     folder's identity.  You cannot change the folder's identity
  23.     (via IPersistFolder::Initialize) while there are outstanding
  24.     subobjects.
  26.     The number of cBusy's never exceeds the number of cRef's, because
  27.     each subobject that requires the folder identity must retain a
  28.     reference to the folder itself.  That way, the folder won't be
  29.     Release()d while the identity is still needed.
  31.     Name Space description (for m_pidlComplete & m_nIDOffsetToOurNameSpaceRoot):
  32.     The name space is provided by the shell to describe resources for the user.
  33.     This class is a base implementation so users can create their own name space
  34.     that is rooted in the shell's name space.  A PIDL is a list of ItemID, each of
  35.     which represent one level in the name space.  The list provides a path thru
  36.     the name space to a specific item.  Example:
  37.     [Desktop][My Computer][C:][Dir1][Dir2][File.htm][#goto_description_secion]
  38.     [Desktop][The Internet][ftp://server/][Dir1][Dir2][file.txt]
  39.     [Desktop][My Computer][PrivateNS lvl1][lvl2][lvl3]...
  40.     (Public Name Space)   (Private Name Space)
  41.     [GNS Level1][GNS Levl2][Pri LVL1][P LVL2][P LVL3]...
  43.     In the example immediately above, this CBaseFolder can create a name space
  44.     under "My Computer" that has 3 levels (lvl1, lvl2, lvl3).  An instance of this
  45.     COM object will be positioned at one level of the sub name space (lvl1, lvl2, or lvl3).
  47.     m_pidlComplete - is the list of ItemIDs from the base [Desktop] to the current location
  48.                 maybe lvl2.
  49.     m_nIDOffsetToOurNameSpaceRoot - is the number of bytes of m_pidlComplete that you need
  50.                 to skip to get to the first ItemID in the private name space (which
  51.                 is the name space owned by this class).
  52. *****************************************************************************/
  54. class CBaseFolder       : public IShellFolder2
  55.                         , public IPersistFolder3
  56.                         , public CObjectWithSite
  57. {
  58. public:
  59.     //////////////////////////////////////////////////////
  60.     // Public Interfaces
  61.     //////////////////////////////////////////////////////
  62.     
  63.     // *** IUnknown ***
  64.     virtual STDMETHODIMP_(ULONG) AddRef(void);
  65.     virtual STDMETHODIMP_(ULONG) Release(void);
  66.     virtual STDMETHODIMP QueryInterface(REFIID riid, LPVOID * ppvObj);
  67.     
  68.     // *** IShellFolder ***
  69.     virtual STDMETHODIMP ParseDisplayName(HWND hwndOwner, LPBC pbcReserved, LPOLESTR lpszDisplayName,
  70.                                             ULONG * pchEaten, LPITEMIDLIST * ppidl, ULONG *pdwAttributes);
  71.     virtual STDMETHODIMP EnumObjects(HWND hwndOwner, DWORD grfFlags, LPENUMIDLIST * ppenumIDList);
  72.     virtual STDMETHODIMP BindToObject(LPCITEMIDLIST pidl, LPBC pbcReserved, REFIID riid, LPVOID * ppvOut);
  73.     virtual STDMETHODIMP BindToStorage(LPCITEMIDLIST pidl, LPBC pbcReserved, REFIID riid, LPVOID * ppvObj);
  74.     virtual STDMETHODIMP CompareIDs(LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2);
  75.     virtual STDMETHODIMP CreateViewObject(HWND hwndOwner, REFIID riid, LPVOID * ppvOut);
  76.     virtual STDMETHODIMP GetAttributesOf(UINT cidl, LPCITEMIDLIST * apidl, ULONG * rgfInOut);
  77.     virtual STDMETHODIMP GetUIObjectOf(HWND hwndOwner, UINT cidl, LPCITEMIDLIST * apidl, REFIID riid, UINT * prgfInOut, LPVOID * ppvOut);
  78.     virtual STDMETHODIMP GetDisplayNameOf(LPCITEMIDLIST pidl, DWORD uFlags, LPSTRRET lpName);
  79.     virtual STDMETHODIMP SetNameOf(HWND hwndOwner, LPCITEMIDLIST pidl, LPCOLESTR lpszName, DWORD uFlags, LPITEMIDLIST * ppidlOut);
  81.     // *** IShellFolder2 ***
  82.     virtual STDMETHODIMP GetDefaultSearchGUID(GUID *pguid) {return E_NOTIMPL;};
  83.     virtual STDMETHODIMP EnumSearches(IEnumExtraSearch **ppenum) {return E_NOTIMPL;};
  84.     virtual STDMETHODIMP GetDefaultColumn(DWORD dwRes, ULONG *pSort, ULONG *pDisplay) {return E_NOTIMPL;};
  85.     virtual STDMETHODIMP GetDefaultColumnState(UINT iColumn, DWORD *pcsFlags) {return E_NOTIMPL;};
  86.     virtual STDMETHODIMP GetDetailsEx(LPCITEMIDLIST pidl, const SHCOLUMNID *pscid, VARIANT *pv) {return E_NOTIMPL;};
  87.     virtual STDMETHODIMP GetDetailsOf(LPCITEMIDLIST pidl, UINT iColumn, SHELLDETAILS *psd) {return E_NOTIMPL;};
  88.     virtual STDMETHODIMP MapColumnToSCID(UINT iCol, SHCOLUMNID *pscid) {return E_NOTIMPL;};
  90.     // *** IPersist ***
  91.     virtual STDMETHODIMP GetClassID(LPCLSID lpClassID);
  93.     // *** IPersistFolder ***
  94.     virtual STDMETHODIMP Initialize(LPCITEMIDLIST pidl);
  95.     
  96.     // *** IPersistFolder2 ***
  97.     virtual STDMETHODIMP GetCurFolder(LPITEMIDLIST *ppidl);
  99.     // *** IPersistFolder3 ***
  100.     virtual STDMETHODIMP InitializeEx(IBindCtx *pbc, LPCITEMIDLIST pidlRoot, const PERSIST_FOLDER_TARGET_INFO *ppfti);
  101.     virtual STDMETHODIMP GetFolderTargetInfo(PERSIST_FOLDER_TARGET_INFO *ppfti);
  103. public:
  104.     CBaseFolder(LPCLSID pClassID);
  105.     virtual ~CBaseFolder(void);
  107.     // Public Member Functions
  108.     virtual HRESULT _GetUIObjectOf(HWND hwndOwner, UINT cidl, LPCITEMIDLIST * apidl, REFIID riid, UINT * prgfInOut, LPVOID * ppvOut, BOOL fFromCreateViewObject);
  109.     virtual HRESULT _Initialize(LPCITEMIDLIST pidlRoot, LPCITEMIDLIST pidlAliasRoot, int nBytesToPrivate);
  110.     virtual HRESULT _CreateShellView(HWND hwndOwner, void ** ppvObj) = 0;       // PURE
  111.     virtual HRESULT _CreateShellView(HWND hwndOwner, void ** ppvObj, LONG lEvents, FOLDERVIEWMODE fvm, IShellFolderViewCB * psfvCallBack, 
  112.                             LPCITEMIDLIST pidl, LPFNVIEWCALLBACK pfnCallback);
  114.     LPCITEMIDLIST GetPublicTargetPidlReference(void) { return m_pidl;};
  115.     LPITEMIDLIST GetPublicTargetPidlClone(void) { return ILClone(GetPublicTargetPidlReference());};
  116.     LPCITEMIDLIST GetPublicRootPidlReference(void) { return (m_pidlRoot ? m_pidlRoot : m_pidl);};
  117.     LPITEMIDLIST GetPublicRootPidlClone(void) { return ILClone(GetPublicRootPidlReference());};
  118.     LPCITEMIDLIST GetPrivatePidlReference(void);
  119.     LPITEMIDLIST GetPrivatePidlClone(void) { return ILClone(GetPrivatePidlReference());};
  120.     LPITEMIDLIST GetPublicPidlRootIDClone(void);
  121.     LPITEMIDLIST CreateFullPublicPidlFromRelative(LPCITEMIDLIST pidlPrivateSubPidl);
  122.     LPITEMIDLIST CreateFullPrivatePidl(LPCITEMIDLIST pidlPrivateSubPidl);
  123.     LPITEMIDLIST CreateFullPublicPidl(LPCITEMIDLIST pidlPrivatePidl);
  125.     LPCITEMIDLIST GetFolderPidl(void) { return m_pidlRoot;};
  127. protected:
  128.     int                     m_cRef;
  130.     int GetPidlByteOffset(void) { return m_nIDOffsetToPrivate;};
  132. private:
  133.     LPITEMIDLIST            m_pidl;                 // Public Pidl - Complete list of IDs from very base of NameSpace to this name space and into this name space to the point of being rooted.
  134.     LPITEMIDLIST            m_pidlRoot;             // Pidl of Folder Shortcut.
  135.     int                     m_nIDOffsetToPrivate;   // number of bytes from the start of m_pidlComplete to the first ItemID in our name space.
  136.     LPCLSID                 m_pClassID;             // My CLSID
  137. };
  139. #endif // _DEFAULT_ISHELLFOLDER_H