#include <CISFBand.h>

Inheritance diagram for CISFBand:

[legend]

Collaboration diagram for CISFBand:

[legend]

Public Member Functions
	CISFBand ()

virtual	~CISFBand ()

HRESULT	CreateSimpleToolbar (HWND hWndParent)

STDMETHOD()	ContainsWindow (IN HWND hWnd)

STDMETHOD()	GetSite (IN REFIID riid, OUT void **ppvSite) override

STDMETHOD()	SetSite (IN IUnknown *pUnkSite) override

STDMETHOD()	GetWindow (OUT HWND *phwnd) override

STDMETHOD()	ContextSensitiveHelp (IN BOOL fEnterMode) override

STDMETHOD()	ShowDW (IN BOOL bShow) override

STDMETHOD()	CloseDW (IN DWORD dwReserved) override

STDMETHOD()	ResizeBorderDW (LPCRECT prcBorder, IUnknown *punkToolbarSite, BOOL fReserved) override

STDMETHOD()	GetBandInfo (IN DWORD dwBandID, IN DWORD dwViewMode, IN OUT DESKBANDINFO *pdbi) override

STDMETHOD()	GetClassID (OUT CLSID *pClassID) override

STDMETHOD()	GetSizeMax (OUT ULARGE_INTEGER *pcbSize) override

STDMETHOD()	IsDirty () override

STDMETHOD()	Load (IN IStream *pStm) override

STDMETHOD()	Save (IN IStream *pStm, IN BOOL fClearDirty) override

STDMETHOD()	OnWinEvent (HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT *theResult) override

STDMETHOD()	IsWindowOwner (HWND hWnd) override

STDMETHOD()	Exec (IN const GUID pguidCmdGroup, IN DWORD nCmdID, IN DWORD nCmdexecopt, IN VARIANT pvaIn, IN OUT VARIANT *pvaOut) override

STDMETHOD()	QueryStatus (IN const GUID pguidCmdGroup, IN ULONG cCmds, IN OUT OLECMD prgCmds[], IN OUT OLECMDTEXT pCmdText) override

STDMETHOD()	GetBandInfoSFB (PBANDINFOSFB pbi) override

STDMETHOD()	InitializeSFB (IShellFolder *psf, PCIDLIST_ABSOLUTE pidl) override

STDMETHOD()	SetBandInfoSFB (PBANDINFOSFB pbi) override

STDMETHOD()	GetCommandString (UINT_PTR idCmd, UINT uFlags, UINT *pwReserved, LPSTR pszName, UINT cchMax) override

STDMETHOD()	InvokeCommand (LPCMINVOKECOMMANDINFO pici) override

STDMETHOD()	QueryContextMenu (HMENU hmenu, UINT indexMenu, UINT idCmdFirst, UINT idCmdLast, UINT uFlags) override

LRESULT	OnChangeNotify (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnTimer (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

LRESULT	OnDestroy (UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)

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 ()

Public Member Functions inherited from IObjectWithSite
HRESULT	SetSite ([in] IUnknown *pUnkSite)

HRESULT	GetSite ([in] REFIID riid, [out, iid_is(riid)] PVOID *ppvSite)

Public Member Functions inherited from IUnknown
HRESULT	QueryInterface ([in] REFIID riid, [out, iid_is(riid)] void **ppvObject)

ULONG	AddRef ()

ULONG	Release ()

Public Member Functions inherited from IDeskBand
HRESULT	GetBandInfo ([in] DWORD dwBandID, [in] DWORD dwViewMode, [in, out] DESKBANDINFO *pdbi)

Public Member Functions inherited from IDockingWindow
HRESULT	ShowDW ([in] BOOL fShow)

HRESULT	CloseDW ([in] DWORD dwReserved)

HRESULT	ResizeBorderDW ([in] LPCRECT prcBorder, [in] IUnknown *punkToolbarSite, [in] BOOL fReserved)

Public Member Functions inherited from IOleWindow
HRESULT	GetWindow ([out] HWND *phwnd)

HRESULT	ContextSensitiveHelp ([in] BOOL fEnterMode)

Public Member Functions inherited from IPersistStream
HRESULT	IsDirty ()

HRESULT	Load ([in, unique] IStream *pStm)

HRESULT	Save ([in, unique] IStream *pStm, [in] BOOL fClearDirty)

HRESULT	GetSizeMax ([out] ULARGE_INTEGER *pcbSize)

Public Member Functions inherited from IPersist
HRESULT	GetClassID ([out] CLSID *pClassID)

Public Member Functions inherited from IOleCommandTarget
HRESULT	QueryStatus ([in, unique] const GUID pguidCmdGroup, [in] ULONG cCmds, [in, out, size_is(cCmds)] OLECMD prgCmds[], [in, out, unique] OLECMDTEXT pCmdText)

HRESULT	Exec ([in, unique] const GUID pguidCmdGroup, [in] DWORD nCmdID, [in] DWORD nCmdexecopt, [in, unique] VARIANT pvaIn, [in, out, unique] VARIANT *pvaOut)

HRESULT	QueryContextMenu ([in] HMENU hmenu, [in] UINT indexMenu, [in] UINT idCmdFirst, [in] UINT idCmdLast, [in] UINT uFlags)

HRESULT	InvokeCommand ([in] LPCMINVOKECOMMANDINFO lpici)

HRESULT	GetCommandString ([in] UINT_PTR idCmd, [in] UINT uType, [out] UINT *pwReserved, [out, size_is(cchMax)] LPSTR pszName, [in] UINT cchMax)

Private Member Functions
BOOL	RegisterChangeNotify (_In_ BOOL bRegister)

HRESULT	AddToolbarButtons ()

void	DeleteToolbarButtons ()

HRESULT	RefreshToolbar ()

HRESULT	SetImageListIconSize (_In_ BOOL bSmall)

HRESULT	BandInfoChanged ()

HRESULT	ShowHideText (_In_ BOOL bShow)

Private Attributes
DWORD	m_BandID

CComPtr< IUnknown >	m_Site

CComPtr< IShellFolder >	m_pISF

CComHeapPtr< ITEMIDLIST_ABSOLUTE >	m_pidl

UINT	m_uChangeNotify

BOOL	m_bShowText

BOOL	m_bSmallIcon

BOOL	m_QLaunch

Additional Inherited Members
Public Types inherited from IObjectWithSite
typedef IObjectWithSite *	LPOBJECTWITHSITE

Public Types inherited from IUnknown
typedef IUnknown *	LPUNKNOWN

Public Types inherited from IOleWindow
typedef IOleWindow *	LPOLEWINDOW

Public Types inherited from IPersistStream
typedef IPersistStream *	LPPERSISTSTREAM

Public Types inherited from IPersist
typedef IPersist *	LPPERSIST

Public Types inherited from IOleCommandTarget
enum	OLECMDF { OLECMDF_SUPPORTED = 0x1 , OLECMDF_ENABLED = 0x2 , OLECMDF_LATCHED = 0x4 , OLECMDF_NINCHED = 0x8 , OLECMDF_INVISIBLE = 0x10 , OLECMDF_DEFHIDEONCTXTMENU = 0x20 }

enum	OLECMDTEXTF { OLECMDTEXTF_NONE = 0 , OLECMDTEXTF_NAME = 1 , OLECMDTEXTF_STATUS = 2 }

enum	OLECMDEXECOPT { OLECMDEXECOPT_DODEFAULT = 0 , OLECMDEXECOPT_PROMPTUSER = 1 , OLECMDEXECOPT_DONTPROMPTUSER = 2 , OLECMDEXECOPT_SHOWHELP = 3 }

enum	OLECMDID { OLECMDID_OPEN = 1 , OLECMDID_NEW = 2 , OLECMDID_SAVE = 3 , OLECMDID_SAVEAS = 4 , OLECMDID_SAVECOPYAS = 5 , OLECMDID_PRINT = 6 , OLECMDID_PRINTPREVIEW = 7 , OLECMDID_PAGESETUP = 8 , OLECMDID_SPELL = 9 , OLECMDID_PROPERTIES = 10 , OLECMDID_CUT = 11 , OLECMDID_COPY = 12 , OLECMDID_PASTE = 13 , OLECMDID_PASTESPECIAL = 14 , OLECMDID_UNDO = 15 , OLECMDID_REDO = 16 , OLECMDID_SELECTALL = 17 , OLECMDID_CLEARSELECTION = 18 , OLECMDID_ZOOM = 19 , OLECMDID_GETZOOMRANGE = 20 , OLECMDID_UPDATECOMMANDS = 21 , OLECMDID_REFRESH = 22 , OLECMDID_STOP = 23 , OLECMDID_HIDETOOLBARS = 24 , OLECMDID_SETPROGRESSMAX = 25 , OLECMDID_SETPROGRESSPOS = 26 , OLECMDID_SETPROGRESSTEXT = 27 , OLECMDID_SETTITLE = 28 , OLECMDID_SETDOWNLOADSTATE = 29 , OLECMDID_STOPDOWNLOAD = 30 , OLECMDID_ONTOOLBARACTIVATED = 31 , OLECMDID_FIND = 32 , OLECMDID_DELETE = 33 , OLECMDID_HTTPEQUIV = 34 , OLECMDID_HTTPEQUIV_DONE = 35 , OLECMDID_ENABLE_INTERACTION = 36 , OLECMDID_ONUNLOAD = 37 , OLECMDID_PROPERTYBAG2 = 38 , OLECMDID_PREREFRESH = 39 , OLECMDID_SHOWSCRIPTERROR = 40 , OLECMDID_SHOWMESSAGE = 41 , OLECMDID_SHOWFIND = 42 , OLECMDID_SHOWPAGESETUP = 43 , OLECMDID_SHOWPRINT = 44 , OLECMDID_CLOSE = 45 , OLECMDID_ALLOWUILESSSAVEAS = 46 , OLECMDID_DONTDOWNLOADCSS = 47 , OLECMDID_UPDATEPAGESTATUS = 48 , OLECMDID_PRINT2 = 49 , OLECMDID_PRINTPREVIEW2 = 50 , OLECMDID_SETPRINTTEMPLATE = 51 , OLECMDID_GETPRINTTEMPLATE = 52 , OLECMDID_PAGEACTIONBLOCKED = 55 , OLECMDID_PAGEACTIONUIQUERY = 56 , OLECMDID_FOCUSVIEWCONTROLS = 57 , OLECMDID_FOCUSVIEWCONTROLSQUERY = 58 , OLECMDID_SHOWPAGEACTIONMENU = 59 , OLECMDID_ADDTRAVELENTRY = 60 , OLECMDID_UPDATETRAVELENTRY = 61 , OLECMDID_UPDATEBACKFORWARDSTATE = 62 , OLECMDID_OPTICAL_ZOOM = 63 , OLECMDID_OPTICAL_GETZOOMRANGE = 64 , OLECMDID_WINDOWSTATECHANGED = 65 , OLECMDID_ACTIVEXINSTALLSCOPE = 66 , OLECMDID_UPDATETRAVELENTRY_DATARECOVERY = 67 , OLECMDID_SHOWTASKDLG = 68 , OLECMDID_POPSTATEEVENT = 69 , OLECMDID_VIEWPORT_MODE = 70 , OLECMDID_LAYOUT_VIEWPORT_WIDTH = 71 , OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM = 72 , OLECMDID_USER_OPTICAL_ZOOM = 73 , OLECMDID_PAGEAVAILABLE = 74 , OLECMDID_GETUSERSCALABLE = 75 , OLECMDID_UPDATE_CARET = 76 , OLECMDID_ENABLE_VISIBILITY = 77 , OLECMDID_MEDIA_PLAYBACK = 78 }

typedef IOleCommandTarget *	LPOLECOMMANDTARGET

typedef enum IOleCommandTarget::OLECMDF	OLECMDF

typedef struct IOleCommandTarget::_tagOLECMD	OLECMD

typedef struct IOleCommandTarget::_tagOLECMDTEXT	OLECMDTEXT

typedef enum IOleCommandTarget::OLECMDTEXTF	OLECMDTEXTF

typedef enum IOleCommandTarget::OLECMDEXECOPT	OLECMDEXECOPT

typedef enum IOleCommandTarget::OLECMDID	OLECMDID

Public Types inherited from IContextMenu
typedef IContextMenu *	LPCONTEXTMENU

typedef struct IContextMenu::tagCMINVOKECOMMANDINFO	CMINVOKECOMMANDINFO

typedef struct IContextMenu::tagCMINVOKECOMMANDINFO *	LPCMINVOKECOMMANDINFO

typedef struct IContextMenu::tagCMInvokeCommandInfoEx	CMINVOKECOMMANDINFOEX

typedef struct IContextMenu::tagCMInvokeCommandInfoEx *	LPCMINVOKECOMMANDINFOEX

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)

Public Attributes inherited from ATL::CComObjectRootBase
LONG	m_dwRef

Static Public Attributes inherited from IContextMenu
static const WCHAR	CMDSTR_NEWFOLDERW [] = {'N','e','w','F','o','l','d','e','r',0}

static const WCHAR	CMDSTR_VIEWLISTW [] = {'V','i','e','w','L','i','s','t',0}

static const WCHAR	CMDSTR_VIEWDETAILSW [] = {'V','i','e','w','D','e','t','a','i','l','s',0}

Detailed Description

Definition at line 14 of file CISFBand.h.

Constructor & Destructor Documentation

◆ CISFBand()

CISFBand::CISFBand ( )

Definition at line 33 of file CISFBand.cpp.

    : m_BandID(0)
    , m_uChangeNotify(0)
    , m_bShowText(TRUE)
    , m_bSmallIcon(TRUE)
    , m_QLaunch(FALSE)
{
}

◆ ~CISFBand()

CISFBand::~CISFBand ( )

virtual

Definition at line 42 of file CISFBand.cpp.

43{

44}

Member Function Documentation

◆ AddToolbarButtons()

HRESULT CISFBand::AddToolbarButtons ( )

private

Definition at line 70 of file CISFBand.cpp.

{
    CComPtr<IEnumIDList> pEnum;
    HRESULT hr = m_pISF->EnumObjects(0, SHCONTF_FOLDERS | SHCONTF_NONFOLDERS, &pEnum);
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    LPITEMIDLIST pidl;
    for (INT iItem = 0; pEnum->Next(1, &pidl, NULL) == S_OK; ++iItem)
    {
        STRRET strret;
        hr = m_pISF->GetDisplayNameOf(pidl, SHGDN_NORMAL, &strret);
 
        WCHAR szText[MAX_PATH];
        if (FAILED_UNEXPECTEDLY(hr))
            szText[0] = UNICODE_NULL;
        else
            StrRetToBufW(&strret, pidl, szText, _countof(szText));
 
        INT iImage = SHMapPIDLToSystemImageListIndex(m_pISF, pidl, NULL);
        TBBUTTON tb = { iImage, iItem, TBSTATE_ENABLED, BTNS_AUTOSIZE, { 0 },
                        (DWORD_PTR)pidl, (INT_PTR)szText };
        SendMessage(TB_INSERTBUTTONW, iItem, (LPARAM)&tb);
    }
 
    SendMessage(TB_AUTOSIZE, 0, 0);
    return BandInfoChanged();
}

Referenced by CreateSimpleToolbar(), and RefreshToolbar().

◆ BandInfoChanged()

HRESULT CISFBand::BandInfoChanged ( )

private

Definition at line 152 of file CISFBand.cpp.

{
    if (!m_Site)
        return S_OK;
    HRESULT hr = IUnknown_Exec(m_Site, IID_IDeskBand, DBID_BANDINFOCHANGED, 0, NULL, NULL);
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
    return S_OK;
}

Referenced by AddToolbarButtons(), InvokeCommand(), and SetBandInfoSFB().

◆ CloseDW()

STDMETHODIMP CISFBand::CloseDW ( IN DWORD dwReserved )

override

Definition at line 276 of file CISFBand.cpp.

{
    if (m_hWnd)
    {
        DestroyWindow();
        return S_OK;
    }
 
    return E_FAIL;
}

◆ ContainsWindow()

STDMETHODIMP CISFBand::ContainsWindow ( IN HWND hWnd )

Definition at line 402 of file CISFBand.cpp.

{
    if (hWnd == m_hWnd || IsChild(hWnd))
    {
        TRACE("CISFBand::ContainsWindow(0x%p) returns S_OK\n", hWnd);
        return S_OK;
    }
 
    return S_FALSE;
}

◆ ContextSensitiveHelp()

STDMETHODIMP CISFBand::ContextSensitiveHelp ( IN BOOL fEnterMode )

override

Definition at line 259 of file CISFBand.cpp.

{
    /* FIXME: Implement */
    return E_NOTIMPL;
}

◆ CreateSimpleToolbar()

HRESULT CISFBand::CreateSimpleToolbar ( HWND hWndParent )

Definition at line 46 of file CISFBand.cpp.

{
    // Create the toolbar.
    DWORD style = WS_CHILD | TBSTYLE_FLAT | TBSTYLE_LIST | CCS_NORESIZE | CCS_NODIVIDER;
    HWND hwndToolbar = ::CreateWindowExW(0, TOOLBARCLASSNAMEW, NULL, style, 0, 0, 0, 0,
                                         hWndParent, NULL, 0, NULL);
    if (!hwndToolbar)
        return E_FAIL;
 
    SubclassWindow(hwndToolbar);
    ATLASSERT(m_hWnd);
 
    ShowHideText(m_bShowText);
    SetImageListIconSize(m_bSmallIcon);
 
    return AddToolbarButtons();
}

Referenced by SetSite().

◆ DeleteToolbarButtons()

void CISFBand::DeleteToolbarButtons ( )

private

Definition at line 99 of file CISFBand.cpp.

{
    // Assumption: Deleting a button causes the remaining buttons to shift,
    // so the next button always appears at index 0. This ensures the loop
    // progresses and avoids infinite loops.
    TBBUTTON tb;
    while (SendMessage(TB_GETBUTTON, 0, (LPARAM)&tb))
    {
        CoTaskMemFree((LPITEMIDLIST)tb.dwData);
        SendMessage(TB_DELETEBUTTON, 0, 0);
    }
}

Referenced by OnDestroy(), and RefreshToolbar().

◆ Exec()

STDMETHODIMP CISFBand::Exec	(	IN const GUID *	pguidCmdGroup,
		IN DWORD	nCmdID,
		IN DWORD	nCmdexecopt,
		IN VARIANT *	pvaIn,
		IN OUT VARIANT *	pvaOut
	)

override

Definition at line 509 of file CISFBand.cpp.

{
    if (IsEqualIID(*pguidCmdGroup, IID_IBandSite))
        return S_OK;
 
    if (IsEqualIID(*pguidCmdGroup, IID_IDeskBand))
    {
        if (nCmdID == DBID_SETWINDOWTHEME)
        {
            if (pvaIn && V_VT(pvaIn) == VT_BSTR && V_BSTR(pvaIn))
            {
                SetWindowTheme(m_hWnd, V_BSTR(pvaIn), NULL);
            }
        }
        return S_OK;
    }
 
    UNIMPLEMENTED;
 
    return E_NOTIMPL;
}

◆ GetBandInfo()

STDMETHODIMP CISFBand::GetBandInfo	(	IN DWORD	dwBandID,
		IN DWORD	dwViewMode,
		IN OUT DESKBANDINFO *	pdbi
	)

override

Definition at line 293 of file CISFBand.cpp.

{
    TRACE("CTaskBand::GetBandInfo(0x%x,0x%x,0x%p) hWnd=0x%p\n", dwBandID, dwViewMode, pdbi, m_hWnd);
 
    if (m_hWnd && pdbi)
    {
        m_BandID = dwBandID;
 
        RECT actualRect;
        POINTL actualSize;
        POINTL idealSize;
        POINTL maxSize;
        POINTL itemSize;
 
        GetWindowRect(&actualRect);
        actualSize.x = actualRect.right - actualRect.left;
        actualSize.y = actualRect.bottom - actualRect.top;
 
        // Obtain the ideal size, to be used as min and max
        SendMessageW(m_hWnd, TB_AUTOSIZE, 0, 0);
        SendMessageW(m_hWnd, TB_GETMAXSIZE, 0, reinterpret_cast<LPARAM>(&maxSize));
 
        idealSize = maxSize;
        SendMessageW(m_hWnd, TB_GETIDEALSIZE, FALSE, reinterpret_cast<LPARAM>(&idealSize));
 
        // Obtain the button size, to be used as the integral size
        DWORD size = SendMessageW(m_hWnd, TB_GETBUTTONSIZE, 0, 0);
        itemSize.x = GET_X_LPARAM(size);
        itemSize.y = GET_Y_LPARAM(size);
 
        if (pdbi->dwMask & DBIM_MINSIZE)
        {
            if (m_QLaunch)
                pdbi->ptMinSize.x = idealSize.x;
            else
                pdbi->ptMinSize.x = -1;
            pdbi->ptMinSize.y = idealSize.y;
        }
        if (pdbi->dwMask & DBIM_MAXSIZE)
        {
            pdbi->ptMaxSize = maxSize;
        }
        if (pdbi->dwMask & DBIM_INTEGRAL)
        {
            pdbi->ptIntegral = itemSize;
        }
        if (pdbi->dwMask & DBIM_ACTUAL)
        {
            pdbi->ptActual = actualSize;
        }
        if (pdbi->dwMask & DBIM_TITLE)
        {
            if (m_QLaunch || !ILGetDisplayNameEx(NULL, m_pidl, pdbi->wszTitle, ILGDN_INFOLDER))
            {
                pdbi->dwMask &= ~DBIM_TITLE;
            }
        }
        if (pdbi->dwMask & DBIM_MODEFLAGS)
        {
            pdbi->dwModeFlags = DBIMF_NORMAL | DBIMF_VARIABLEHEIGHT | DBIMF_USECHEVRON | DBIMF_NOMARGINS | DBIMF_BKCOLOR;
            if (m_QLaunch)
            {
                pdbi->dwModeFlags |= DBIMF_ADDTOFRONT;
            }
        }
        if (pdbi->dwMask & DBIM_BKCOLOR)
            pdbi->dwMask &= ~DBIM_BKCOLOR;
 
        return S_OK;
    }
 
    return E_FAIL;
}

◆ GetBandInfoSFB()

STDMETHODIMP CISFBand::GetBandInfoSFB ( PBANDINFOSFB pbi )

override

Definition at line 533 of file CISFBand.cpp.

{
    if (pbi->dwMask == ISFB_MASK_IDLIST)
    {
        pbi->pidl = ILClone(m_pidl);
        if (!pbi->pidl)
            return E_OUTOFMEMORY;
        return S_OK;
    }
 
    return E_NOTIMPL;
}

◆ GetClassID()

STDMETHODIMP CISFBand::GetClassID ( OUT CLSID * pClassID )

override

Definition at line 369 of file CISFBand.cpp.

{
    *pClassID = CLSID_ISFBand;
    return S_OK;
}

◆ GetCommandString()

STDMETHODIMP CISFBand::GetCommandString	(	UINT_PTR	idCmd,
		UINT	uFlags,
		UINT *	pwReserved,
		LPSTR	pszName,
		UINT	cchMax
	)

override

Implements IContextMenu.

Definition at line 615 of file CISFBand.cpp.

{
    /*HRESULT hr = E_INVALIDARG;
 
    if (idCmd == IDM_DISPLAY)
    {
        switch (uFlags)
        {
        case GCS_HELPTEXTW:
            // Only useful for pre-Vista versions of Windows that
            // have a Status bar.
            hr = StringCchCopyW(reinterpret_cast<PWSTR>(pszName),
                cchMax,
                L"Display File Name");
            break;
 
        case GCS_VERBW:
            // GCS_VERBW is an optional feature that enables a caller
            // to discover the canonical name for the verb that is passed in
            // through idCommand.
            hr = StringCchCopyW(reinterpret_cast<PWSTR>(pszName),
                cchMax,
                L"DisplayFileName");
            break;
        }
    }
    return hr;  */
 
    return S_OK;
}

◆ GetSite()

STDMETHODIMP CISFBand::GetSite	(	IN REFIID	riid,
		OUT void **	ppvSite
	)

override

Definition at line 231 of file CISFBand.cpp.

{
    TRACE("CISFBand::GetSite(0x%p,0x%p)\n", riid, ppvSite);
 
    HRESULT hr;
    if (m_Site != NULL)
    {
        hr = m_Site->QueryInterface(riid, ppvSite);
        if (FAILED(hr)) return hr;
    }
 
    *ppvSite = NULL;
    return E_FAIL;
}

◆ GetSizeMax()

STDMETHODIMP CISFBand::GetSizeMax ( OUT ULARGE_INTEGER * pcbSize )

override

Definition at line 394 of file CISFBand.cpp.

{
    TRACE("CISFBand::GetSizeMax called\n");
    return S_OK;
}

◆ GetWindow()

STDMETHODIMP CISFBand::GetWindow ( OUT HWND * phwnd )

override

Definition at line 248 of file CISFBand.cpp.

{
    if (!m_hWnd)
        return E_FAIL;
    if (!phwnd)
        return E_POINTER;
    *phwnd = m_hWnd;
 
    return S_OK;
}

◆ InitializeSFB()

STDMETHODIMP CISFBand::InitializeSFB	(	IShellFolder *	psf,
		PCIDLIST_ABSOLUTE	pidl
	)

override

Definition at line 546 of file CISFBand.cpp.

{
    HRESULT hr;
 
    if (!psf && !pidl)
        return E_INVALIDARG;
 
    if (psf && pidl)
        return E_INVALIDARG;
 
    m_pidl.Free();
 
    if (pidl != NULL)
    {
        CComPtr<IShellFolder> psfDesktop;
        hr = SHGetDesktopFolder(&psfDesktop);
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
 
        if (_ILIsDesktop(pidl))
        {
            m_pISF = psfDesktop;
        }
        else
        {
            hr = psfDesktop->BindToObject(pidl, NULL, IID_PPV_ARG(IShellFolder, &m_pISF));
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
        }
 
        m_pidl.Attach(ILClone(pidl));
        if (!m_pidl)
            ERR("Out of memory\n");
    }
 
    if (psf != NULL)
    {
        CComPtr<IPersistFolder2> ppf2;
        hr = psf->QueryInterface(IID_PPV_ARG(IPersistFolder2, &ppf2));
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
 
        hr = ppf2->GetCurFolder(&m_pidl);
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
 
        ATLASSERT(m_pidl);
        m_pISF = psf;
    }
 
    return S_OK;
}

◆ InvokeCommand()

STDMETHODIMP CISFBand::InvokeCommand ( LPCMINVOKECOMMANDINFO pici )

override

Implements IContextMenu.

Definition at line 646 of file CISFBand.cpp.

{
    if (!HIWORD(pici->lpVerb))
    {
        switch (LOWORD(pici->lpVerb))
        {
            case IDM_LARGE_ICONS:
            {
                HRESULT hr = SetImageListIconSize(FALSE);
                if (FAILED(hr))
                    return hr;
                return BandInfoChanged();
            }
            case IDM_SMALL_ICONS:
            {
                HRESULT hr = SetImageListIconSize(TRUE);
                if (FAILED(hr))
                    return hr;
                return BandInfoChanged();
            }
            case IDM_OPEN_FOLDER:
            {
                SHELLEXECUTEINFOW shexinfo = { sizeof(shexinfo) };
                shexinfo.fMask = SEE_MASK_IDLIST;
                shexinfo.lpVerb = L"open";
                shexinfo.lpIDList = m_pidl;
                shexinfo.nShow = SW_SHOW;
                if (!ShellExecuteExW(&shexinfo))
                    return E_FAIL;
                break;
            }
            case IDM_SHOW_TEXT:
            {
                ShowHideText(!m_bShowText);
                return BandInfoChanged();
            }
            default:
                return E_FAIL;
        }
    }
 
    return S_OK;
}

◆ IsDirty()

STDMETHODIMP CISFBand::IsDirty ( void )

override

Implements IPersistStream.

Definition at line 375 of file CISFBand.cpp.

{
    /* The object hasn't changed since the last save! */
    return S_FALSE;
}

◆ IsWindowOwner()

STDMETHODIMP CISFBand::IsWindowOwner ( HWND hWnd )

override

Definition at line 495 of file CISFBand.cpp.

{
    return (hWnd == m_hWnd) ? S_OK : S_FALSE;
}

◆ Load()

STDMETHODIMP CISFBand::Load ( IN IStream * pStm )

override

Definition at line 381 of file CISFBand.cpp.

{
    TRACE("CISFBand::Load called\n");
    /* Nothing to do */
    return S_OK;
}

◆ OnChangeNotify()

LRESULT CISFBand::OnChangeNotify	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

Definition at line 185 of file CISFBand.cpp.

{
    // This code reduces the redrawing cost by coalescing multiple change events
    KillTimer(TIMERID_DELAYED_REFRESH);
    SetTimer(TIMERID_DELAYED_REFRESH, TIMER_REFRESH_DELAY);
    return 0;
}

◆ OnDestroy()

LRESULT CISFBand::OnDestroy	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

Definition at line 194 of file CISFBand.cpp.

{
    RegisterChangeNotify(FALSE);
    KillTimer(TIMERID_DELAYED_REFRESH);
    ShowWindow(SW_HIDE);
    DeleteToolbarButtons();
    UnsubclassWindow();
    bHandled = FALSE;
    return 0;
}

◆ OnTimer()

LRESULT CISFBand::OnTimer	(	UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		BOOL &	bHandled
	)

Definition at line 174 of file CISFBand.cpp.

{
    if (wParam == TIMERID_DELAYED_REFRESH)
    {
        KillTimer(wParam);
        RefreshToolbar();
    }
    return 0;
}

◆ OnWinEvent()

STDMETHODIMP CISFBand::OnWinEvent	(	HWND	hWnd,
		UINT	uMsg,
		WPARAM	wParam,
		LPARAM	lParam,
		LRESULT *	theResult
	)

override

Definition at line 413 of file CISFBand.cpp.

{
    switch (uMsg)
    {
        case WM_COMMAND:
        {
            TBBUTTON tb;
            BOOL chk = SendMessage(TB_GETBUTTON, LOWORD(wParam), (LPARAM)&tb);
            if (chk)
                SHInvokeDefaultCommand(m_hWnd, m_pISF, (LPITEMIDLIST)tb.dwData);
 
            if (theResult)
                *theResult = TRUE;
            break;
        }
        case WM_NOTIFY:
        {
            switch (((LPNMHDR)lParam)->code)
            {
                case NM_RCLICK:
                {
                    HRESULT hr;
                    POINT pt = ((LPNMMOUSE)lParam)->pt; // Already in screen coordinates
                    CComPtr<IContextMenu> picm;
                    HMENU fmenu = CreatePopupMenu();
                    TBBUTTON tb;
 
                    bool chk = SendMessage(m_hWnd, TB_GETBUTTON, ((LPNMMOUSE)lParam)->dwItemSpec, (LPARAM)&tb);
                    LPITEMIDLIST pidl = (LPITEMIDLIST)tb.dwData;
 
                    if (chk)
                    {
                        hr = m_pISF->GetUIObjectOf(m_hWnd, 1, &pidl, IID_NULL_PPV_ARG(IContextMenu, &picm));
                        if (FAILED_UNEXPECTEDLY(hr))
                            return hr;
 
                        hr = picm->QueryContextMenu(fmenu, 0, 1, 0x7FFF, CMF_DEFAULTONLY);
                        if (FAILED_UNEXPECTEDLY(hr))
                            return hr;
 
                        int id = TrackPopupMenuEx(fmenu, TPM_LEFTALIGN | TPM_BOTTOMALIGN | TPM_RETURNCMD, pt.x, pt.y, m_hWnd, 0);
                        if (id > 0)
                        {
                            CMINVOKECOMMANDINFOEX info = { 0 };
                            info.cbSize = sizeof(info);
                            info.fMask = CMIC_MASK_PTINVOKE;
                            if (GetKeyState(VK_CONTROL) < 0)
                            {
                                info.fMask |= CMIC_MASK_CONTROL_DOWN;
                            }
                            if (GetKeyState(VK_SHIFT) < 0)
                            {
                                info.fMask |= CMIC_MASK_SHIFT_DOWN;
                            }
                            info.hwnd = m_hWnd;
                            info.lpVerb = MAKEINTRESOURCEA(id - 1);
                            info.nShow = SW_SHOWNORMAL;
                            info.ptInvoke = pt;
                            picm->InvokeCommand((LPCMINVOKECOMMANDINFO)&info);
                        }
                    }
                    DestroyMenu(fmenu);
 
                    if (theResult)
                        *theResult = TRUE;
                    break;
                }
                default:
                    if (theResult)
                        *theResult = FALSE;
            }
 
            break;
        }
        default:
            if (theResult)
                *theResult = FALSE;
    }
 
    return S_OK;
}

◆ QueryContextMenu()

STDMETHODIMP CISFBand::QueryContextMenu	(	HMENU	hmenu,
		UINT	indexMenu,
		UINT	idCmdFirst,
		UINT	idCmdLast,
		UINT	uFlags
	)

override

Implements IContextMenu.

Definition at line 690 of file CISFBand.cpp.

{
    HMENU qMenu = LoadMenu(GetModuleHandleW(L"browseui.dll"), MAKEINTRESOURCE(IDM_POPUPMENU));
 
    CheckMenuItem(qMenu, IDM_SHOW_TEXT, (m_bShowText ? MF_CHECKED : MF_UNCHECKED));
 
    if (m_bSmallIcon)
    {
        CheckMenuItem(qMenu, IDM_SMALL_ICONS, MF_CHECKED);
        CheckMenuItem(qMenu, IDM_LARGE_ICONS, MF_UNCHECKED);
    }
    else
    {
        CheckMenuItem(qMenu, IDM_LARGE_ICONS, MF_CHECKED);
        CheckMenuItem(qMenu, IDM_SMALL_ICONS, MF_UNCHECKED);
    }
 
    if (_ILIsDesktop(m_pidl))
        DeleteMenu(qMenu, IDM_OPEN_FOLDER, MF_BYCOMMAND);
 
    UINT idMax = Shell_MergeMenus(hmenu, GetSubMenu(qMenu, 0), indexMenu, idCmdFirst, idCmdLast, MM_SUBMENUSHAVEIDS);
    DestroyMenu(qMenu);
    return MAKE_HRESULT(SEVERITY_SUCCESS, 0, USHORT(idMax - idCmdFirst +1));
}

◆ QueryStatus()

STDMETHODIMP CISFBand::QueryStatus	(	IN const GUID *	pguidCmdGroup,
		IN ULONG	cCmds,
		IN OUT OLECMD	prgCmds[],
		IN OUT OLECMDTEXT *	pCmdText
	)

override

Definition at line 502 of file CISFBand.cpp.

{
    UNIMPLEMENTED;
 
    return E_NOTIMPL;
}

◆ RefreshToolbar()

HRESULT CISFBand::RefreshToolbar ( )

private

Definition at line 64 of file CISFBand.cpp.

{
    DeleteToolbarButtons();
    return AddToolbarButtons();
}

Referenced by OnTimer().

◆ RegisterChangeNotify()

BOOL CISFBand::RegisterChangeNotify ( _In_ BOOL bRegister )

private

Definition at line 112 of file CISFBand.cpp.

{
    if (bRegister)
    {
        if (!m_pidl)
            return FALSE;
#define SHCNE_WATCH (SHCNE_RENAMEITEM | SHCNE_CREATE | SHCNE_DELETE | SHCNE_MKDIR | \
                     SHCNE_RMDIR | SHCNE_UPDATEDIR | SHCNE_UPDATEITEM | SHCNE_UPDATEIMAGE | \
                     SHCNE_RENAMEFOLDER | SHCNE_ASSOCCHANGED)
        SHChangeNotifyEntry entry = { m_pidl, FALSE };
        m_uChangeNotify = SHChangeNotifyRegister(m_hWnd, SHCNRF_ShellLevel | SHCNRF_NewDelivery,
                                                 SHCNE_WATCH, WM_ISFBAND_CHANGE_NOTIFY,
                                                 1, &entry);
        return m_uChangeNotify != 0;
    }
    else // De-register?
    {
        if (m_uChangeNotify)
        {
            SHChangeNotifyDeregister(m_uChangeNotify);
            m_uChangeNotify = 0;
            return TRUE;
        }
        return FALSE;
    }
}

Referenced by OnDestroy(), and SetSite().

◆ ResizeBorderDW()

STDMETHODIMP CISFBand::ResizeBorderDW	(	LPCRECT	prcBorder,
		IUnknown *	punkToolbarSite,
		BOOL	fReserved
	)

override

Implements IDockingWindow.

Definition at line 287 of file CISFBand.cpp.

{
    /* No need to implement this method */
    return E_NOTIMPL;
}

◆ Save()

STDMETHODIMP CISFBand::Save	(	IN IStream *	pStm,
		IN BOOL	fClearDirty
	)

override

Definition at line 388 of file CISFBand.cpp.

{
    /* Nothing to do */
    return S_OK;
}

◆ SetBandInfoSFB()

STDMETHODIMP CISFBand::SetBandInfoSFB ( PBANDINFOSFB pbi )

override

Definition at line 599 of file CISFBand.cpp.

{
    if ((pbi->dwMask & ISFB_MASK_STATE) &&
        (pbi->dwState & ISFB_STATE_QLINKSMODE) &&
        (pbi->dwStateMask & ISFB_STATE_QLINKSMODE))
    {
        m_QLaunch = TRUE;
        ShowHideText(FALSE);
        return BandInfoChanged();
    }
 
    return E_NOTIMPL;
}

◆ SetImageListIconSize()

HRESULT CISFBand::SetImageListIconSize ( _In_ BOOL bSmall )

private

Definition at line 139 of file CISFBand.cpp.

{
    m_bSmallIcon = bSmall;
 
    CComPtr<IImageList> piml;
    HRESULT hr = SHGetImageList((bSmall ? SHIL_SMALL : SHIL_LARGE), IID_PPV_ARG(IImageList, &piml));
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    SendMessage(TB_SETIMAGELIST, 0, (LPARAM)(HIMAGELIST)piml.Detach());
    return S_OK;
}

Referenced by CreateSimpleToolbar(), and InvokeCommand().

◆ SetSite()

STDMETHODIMP CISFBand::SetSite ( IN IUnknown * pUnkSite )

override

Definition at line 208 of file CISFBand.cpp.

{
    HRESULT hr;
    HWND hwndParent;
 
    TRACE("CISFBand::SetSite(0x%p)\n", pUnkSite);
 
    hr = IUnknown_GetWindow(pUnkSite, &hwndParent);
    if (FAILED(hr))
    {
        TRACE("Querying site window failed: 0x%x\n", hr);
        return hr;
    }
    m_Site = pUnkSite;
 
    hr = CreateSimpleToolbar(hwndParent);
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    RegisterChangeNotify(TRUE);
    return S_OK;
}

◆ ShowDW()

STDMETHODIMP CISFBand::ShowDW ( IN BOOL bShow )

override

Definition at line 265 of file CISFBand.cpp.

{
    if (m_hWnd)
    {
        ShowWindow(bShow ? SW_SHOW : SW_HIDE);
        return S_OK;
    }
 
    return E_FAIL;
}

◆ ShowHideText()

HRESULT CISFBand::ShowHideText ( _In_ BOOL bShow )

private

Definition at line 162 of file CISFBand.cpp.

{
    // NOTE: TBSTYLE_EX_MIXEDBUTTONS hides non-BTNS_SHOWTEXT buttons' text.
    m_bShowText = bShow;
    SendMessage(TB_SETEXTENDEDSTYLE, 0, (bShow ? 0 : TBSTYLE_EX_MIXEDBUTTONS));
    return S_OK;
}

Referenced by CreateSimpleToolbar(), InvokeCommand(), and SetBandInfoSFB().

Member Data Documentation

◆ m_BandID

DWORD CISFBand::m_BandID

private

Definition at line 27 of file CISFBand.h.

Referenced by GetBandInfo().

◆ m_bShowText

BOOL CISFBand::m_bShowText

private

Definition at line 36 of file CISFBand.h.

Referenced by CreateSimpleToolbar(), InvokeCommand(), QueryContextMenu(), and ShowHideText().

◆ m_bSmallIcon

BOOL CISFBand::m_bSmallIcon

private

Definition at line 37 of file CISFBand.h.

Referenced by CreateSimpleToolbar(), QueryContextMenu(), and SetImageListIconSize().

◆ m_pidl

CComHeapPtr<ITEMIDLIST_ABSOLUTE> CISFBand::m_pidl

private

Definition at line 32 of file CISFBand.h.

Referenced by GetBandInfo(), GetBandInfoSFB(), InitializeSFB(), InvokeCommand(), QueryContextMenu(), and RegisterChangeNotify().

◆ m_pISF

CComPtr<IShellFolder> CISFBand::m_pISF

private

Definition at line 31 of file CISFBand.h.

Referenced by AddToolbarButtons(), InitializeSFB(), and OnWinEvent().

◆ m_QLaunch

BOOL CISFBand::m_QLaunch

private

Definition at line 38 of file CISFBand.h.

Referenced by GetBandInfo(), and SetBandInfoSFB().

◆ m_Site

CComPtr<IUnknown> CISFBand::m_Site

private

Definition at line 28 of file CISFBand.h.

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

◆ m_uChangeNotify

UINT CISFBand::m_uChangeNotify

private

Definition at line 33 of file CISFBand.h.

Referenced by RegisterChangeNotify().

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

dll/win32/browseui/shellbars/CISFBand.h
dll/win32/browseui/shellbars/CISFBand.cpp

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CISFBand()

◆ ~CISFBand()

Member Function Documentation

◆ AddToolbarButtons()

◆ BandInfoChanged()

◆ CloseDW()

◆ ContainsWindow()

◆ ContextSensitiveHelp()

◆ CreateSimpleToolbar()

◆ DeleteToolbarButtons()

◆ Exec()

◆ GetBandInfo()

◆ GetBandInfoSFB()

◆ GetClassID()

◆ GetCommandString()

◆ GetSite()

◆ GetSizeMax()

◆ GetWindow()

◆ InitializeSFB()

◆ InvokeCommand()

◆ IsDirty()

◆ IsWindowOwner()

◆ Load()

◆ OnChangeNotify()

◆ OnDestroy()

◆ OnTimer()

◆ OnWinEvent()

◆ QueryContextMenu()

◆ QueryStatus()

◆ RefreshToolbar()

◆ RegisterChangeNotify()

◆ ResizeBorderDW()

◆ Save()

◆ SetBandInfoSFB()

◆ SetImageListIconSize()

◆ SetSite()

◆ ShowDW()

◆ ShowHideText()

Member Data Documentation

◆ m_BandID

◆ m_bShowText

◆ m_bSmallIcon

◆ m_pidl

◆ m_pISF

◆ m_QLaunch

◆ m_Site

◆ m_uChangeNotify