CFolderOptions Class Reference

#include <CFolderOptions.h>

Inheritance diagram for CFolderOptions:

Collaboration diagram for CFolderOptions:

Public Member Functions
	CFolderOptions ()
	~CFolderOptions ()
STDMETHOD()	AddPages (LPFNSVADDPROPSHEETPAGE pfnAddPage, LPARAM lParam) override
STDMETHOD()	ReplacePage (EXPPS uPageID, LPFNSVADDPROPSHEETPAGE pfnReplaceWith, LPARAM lParam) override
STDMETHOD()	Initialize (PCIDLIST_ABSOLUTE pidlFolder, IDataObject *pdtobj, HKEY hkeyProgID) override
STDMETHOD()	SetSite (IUnknown *pUnkSite) override
STDMETHOD()	GetSite (REFIID riid, void **ppvSite) override
bool	CanSetDefFolderSettings ()
HRESULT	ApplyDefFolderSettings (bool ResetToDefault)
Public Member Functions inherited from ATL::CComObjectRootEx< CComMultiThreadModelNoCS >
	~CComObjectRootEx ()
ULONG	InternalAddRef ()
ULONG	InternalRelease ()
void	Lock ()
void	Unlock ()
HRESULT	_AtlInitialConstruct ()
Public Member Functions inherited from ATL::CComObjectRootBase
	CComObjectRootBase ()
	~CComObjectRootBase ()
void	SetVoid (void *)
HRESULT	_AtlFinalConstruct ()
HRESULT	FinalConstruct ()
void	InternalFinalConstructAddRef ()
void	InternalFinalConstructRelease ()
void	FinalRelease ()
HRESULT	AddPages ([in] LPFNSVADDPROPSHEETPAGE pfnAddPage, [in] LPARAM lParam)
HRESULT	ReplacePage ([in] EXPPS uPageID, [in] LPFNSVADDPROPSHEETPAGE pfnReplaceWith, [in] LPARAM lParam)
Public Member Functions inherited from IUnknown
HRESULT	QueryInterface ([in] REFIID riid, [out, iid_is(riid)] void **ppvObject)
ULONG	AddRef ()
ULONG	Release ()
HRESULT	Initialize ([in] PCIDLIST_ABSOLUTE pidlFolder, [in] IDataObject *pdtobj, [in] HKEY hkeyProgID)
Public Member Functions inherited from IObjectWithSite
HRESULT	SetSite ([in] IUnknown *pUnkSite)
HRESULT	GetSite ([in] REFIID riid, [out, iid_is(riid)] PVOID *ppvSite)

Static Public Member Functions
static HRESULT	ResetGlobalAndDefViewFolderSettings ()
Static Public Member Functions inherited from ATL::CComObjectRootBase
static void WINAPI	ObjectMain (bool)
static const struct _ATL_CATMAP_ENTRY *	GetCategoryMap ()
static HRESULT WINAPI	InternalQueryInterface (void *pThis, const _ATL_INTMAP_ENTRY *pEntries, REFIID iid, void **ppvObject)

Protected Types
enum	DEFFOLDERSETTINGACTION { DFSA_QUERY = -1 , DFSA_RESET , DFSA_APPLY }

Protected Member Functions
HRESULT	HandleDefFolderSettings (int Action)

Private Attributes
CComPtr< IUnknown >	m_pSite

Additional Inherited Members
Public Types inherited from IShellPropSheetExt
enum	tagSHELLPROPSHEETEXTPAGEID { EXPPS_FILETYPES = 0x1 }
typedef UINT	EXPPS
Public Types inherited from IUnknown
typedef IUnknown *	LPUNKNOWN
Public Types inherited from IShellExtInit
typedef IShellExtInit *	LPSHELLEXTINIT
Public Types inherited from IObjectWithSite
typedef IObjectWithSite *	LPOBJECTWITHSITE
Public Attributes inherited from ATL::CComObjectRootBase
LONG	m_dwRef

Detailed Description

Definition at line 24 of file CFolderOptions.h.

Member Enumeration Documentation

DEFFOLDERSETTINGACTION

enum CFolderOptions::DEFFOLDERSETTINGACTION

protected

Enumerator
DFSA_QUERY
DFSA_RESET
DFSA_APPLY

Definition at line 42 of file CFolderOptions.h.

{ DFSA_QUERY = -1, DFSA_RESET, DFSA_APPLY };

Constructor & Destructor Documentation

CFolderOptions()

CFolderOptions::CFolderOptions

(

)

Definition at line 27 of file CFolderOptions.cpp.

    :m_pSite(NULL)
{
}

~CFolderOptions()

CFolderOptions::~CFolderOptions

(

)

Definition at line 32 of file CFolderOptions.cpp.

{
}

Member Function Documentation

AddPages()

HRESULT STDMETHODCALLTYPE CFolderOptions::AddPages ( LPFNSVADDPROPSHEETPAGE  pfnAddPage, LPARAM  lParam  )

override

Implements IShellPropSheetExt.

Definition at line 44 of file CFolderOptions.cpp.

{
    HPROPSHEETPAGE hPage;
    LPARAM sheetparam = (LPARAM)static_cast<CFolderOptions*>(this);
 
    hPage = SH_CreatePropertySheetPageEx(IDD_FOLDER_OPTIONS_GENERAL, FolderOptionsGeneralDlg,
                                         sheetparam, NULL, &PropSheetPageLifetimeCallback<CFolderOptions>);
    HRESULT hr = AddPropSheetPage(hPage, pfnAddPage, lParam);
    if (FAILED_UNEXPECTEDLY(hr))
    {
        ERR("Failed to create property sheet page FolderOptionsGeneral\n");
        return hr;
    }
    else
    {
        AddRef(); // For PropSheetPageLifetimeCallback
    }
 
    hPage = SH_CreatePropertySheetPage(IDD_FOLDER_OPTIONS_VIEW, FolderOptionsViewDlg, sheetparam, NULL);
    if (hPage == NULL)
    {
        ERR("Failed to create property sheet page FolderOptionsView\n");
        return E_FAIL;
    }
    if (!pfnAddPage(hPage, lParam))
        return E_FAIL;
 
    hPage = SH_CreatePropertySheetPage(IDD_FOLDER_OPTIONS_FILETYPES, FolderOptionsFileTypesDlg, sheetparam, NULL);
    if (hPage == NULL)
    {
        ERR("Failed to create property sheet page FolderOptionsFileTypes\n");
        return E_FAIL;
    }
    if (!pfnAddPage(hPage, lParam))
        return E_FAIL;
 
    return S_OK;
}

ApplyDefFolderSettings()

HRESULT CFolderOptions::ApplyDefFolderSettings ( bool  ResetToDefault )

inline

Definition at line 64 of file CFolderOptions.h.

        {
            return HandleDefFolderSettings(ResetToDefault ? DFSA_RESET : DFSA_APPLY);
        }

CanSetDefFolderSettings()

bool CFolderOptions::CanSetDefFolderSettings ( )

inline

Definition at line 60 of file CFolderOptions.h.

        {
            return SUCCEEDED(HandleDefFolderSettings(DFSA_QUERY));
        }

GetSite()

HRESULT STDMETHODCALLTYPE CFolderOptions::GetSite ( REFIID  riid, void **  ppvSite  )

override

Definition at line 108 of file CFolderOptions.cpp.

{
    return m_pSite ? m_pSite->QueryInterface(riid, ppvSite) : E_FAIL;
}

HandleDefFolderSettings()

HRESULT CFolderOptions::HandleDefFolderSettings ( int  Action )

protected

Definition at line 155 of file CFolderOptions.cpp.

{
    IBrowserService2 *bs2;
    HRESULT hr = IUnknown_QueryService(m_pSite, SID_SShellBrowser, IID_PPV_ARG(IBrowserService2, &bs2));
    if (SUCCEEDED(hr))
    {
        if (Action == DFSA_APPLY)
        {
            hr = bs2->SetAsDefFolderSettings();
        }
        else if (Action == DFSA_RESET)
        {
            // There does not seem to be a method in IBrowserService2 for this
            ExecResetDefViewFolderSettings(bs2);
        }
        else
        {
            // DFSA_QUERY: hr is already correct
        }
        bs2->Release();
    }
 
    if (Action == DFSA_RESET)
    {
        // In case the browser is hosting a 3rd-party view, we force a DefView reset
        hr = ResetGlobalAndDefViewFolderSettings();
    }
 
    return hr;
}

Referenced by ApplyDefFolderSettings(), and CanSetDefFolderSettings().

Initialize()

HRESULT STDMETHODCALLTYPE CFolderOptions::Initialize ( PCIDLIST_ABSOLUTE  pidlFolder, IDataObject *  pdtobj, HKEY  hkeyProgID  )

override

Implements IShellExtInit.

Definition at line 93 of file CFolderOptions.cpp.

{
    return S_OK;
}

ReplacePage()

HRESULT STDMETHODCALLTYPE CFolderOptions::ReplacePage ( EXPPS  uPageID, LPFNSVADDPROPSHEETPAGE  pfnReplaceWith, LPARAM  lParam  )

override

Implements IShellPropSheetExt.

Definition at line 83 of file CFolderOptions.cpp.

{
    TRACE("(%p) (uPageID %u, pfnReplaceWith %p lParam %p\n", this, uPageID, pfnReplaceWith, lParam);
    return E_NOTIMPL;
}

ResetGlobalAndDefViewFolderSettings()

HRESULT CFolderOptions::ResetGlobalAndDefViewFolderSettings ( )

static

Definition at line 149 of file CFolderOptions.cpp.

{
    ResetDefViewFolderSettings();
    return ResetGlobalFolderSettings();
}

Referenced by FolderOptionsViewDlg(), and HandleDefFolderSettings().

SetSite()

HRESULT STDMETHODCALLTYPE CFolderOptions::SetSite ( IUnknown *  pUnkSite )

override

Implements IObjectWithSite.

Definition at line 102 of file CFolderOptions.cpp.

{
    m_pSite = pUnkSite;
    return S_OK;
}

Member Data Documentation

m_pSite

CComPtr<IUnknown> CFolderOptions::m_pSite

private

Definition at line 32 of file CFolderOptions.h.

Referenced by GetSite(), HandleDefFolderSettings(), and SetSite().

---

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

• dll/win32/shell32/CFolderOptions.h
• dll/win32/shell32/CFolderOptions.cpp