CTaskBand Class Reference

Inheritance diagram for CTaskBand:

Collaboration diagram for CTaskBand:

Public Member Functions
	CTaskBand ()
virtual	~CTaskBand ()
STDMETHODIMP	GetWindow (OUT HWND *phwnd) override
STDMETHODIMP	ContextSensitiveHelp (IN BOOL fEnterMode) override
STDMETHODIMP	ShowDW (IN BOOL bShow) override
STDMETHODIMP	CloseDW (IN DWORD dwReserved) override
STDMETHODIMP	ResizeBorderDW (LPCRECT prcBorder, IUnknown *punkToolbarSite, BOOL fReserved) override
STDMETHODIMP	GetBandInfo (IN DWORD dwBandID, IN DWORD dwViewMode, IN OUT DESKBANDINFO *pdbi) override
STDMETHODIMP	QueryStatus (const GUID *pguidCmdGroup, ULONG cCmds, OLECMD prgCmds[], OLECMDTEXT *pCmdText) override
STDMETHODIMP	Exec (const GUID *pguidCmdGroup, DWORD nCmdID, DWORD nCmdexecopt, VARIANT *pvaIn, VARIANT *pvaOut) override
STDMETHODIMP	SetClient (IN IUnknown *punkClient) override
STDMETHODIMP	GetClient (OUT IUnknown **ppunkClient) override
STDMETHODIMP	OnPosRectChangeDB (IN RECT *prc) override
STDMETHODIMP	GetClassID (OUT CLSID *pClassID) override
STDMETHODIMP	IsDirty () override
STDMETHODIMP	Load (IN IStream *pStm) override
STDMETHODIMP	Save (IN IStream *pStm, IN BOOL fClearDirty) override
STDMETHODIMP	GetSizeMax (OUT ULARGE_INTEGER *pcbSize) override
STDMETHODIMP	SetSite (IUnknown *pUnkSite) override
STDMETHODIMP	GetSite (IN REFIID riid, OUT VOID **ppvSite) override
STDMETHODIMP	OnWinEvent (HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT *theResult) override
STDMETHODIMP	IsWindowOwner (HWND hWnd) override
HRESULT STDMETHODCALLTYPE	Initialize (IN OUT ITrayWindow *tray, HWND hWndStartButton)
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 IDeskBar
HRESULT	SetClient ([in] IUnknown *punkClient)
HRESULT	GetClient ([out] IUnknown **ppunkClient)
HRESULT	OnPosRectChangeDB ([in] RECT *prc)
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)
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)

Private Attributes
CComPtr< ITrayWindow >	m_Tray
CComPtr< IUnknown >	m_Site
CComPtr< IUnknown >	m_TasksWnd
HWND	m_hWnd

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
Static Public Member Functions inherited from ATL::CComCoClass< CTaskBand >
static LPCTSTR WINAPI	GetObjectDescription ()
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

Detailed Description

Definition at line 29 of file taskband.cpp.

Constructor & Destructor Documentation

CTaskBand()

CTaskBand::CTaskBand ( )

inline

Definition at line 46 of file taskband.cpp.

                :
        m_hWnd(NULL)
    {
    }

~CTaskBand()

virtual CTaskBand::~CTaskBand ( )

inlinevirtual

Definition at line 51 of file taskband.cpp.

{ }

Member Function Documentation

CloseDW()

STDMETHODIMP CTaskBand::CloseDW ( IN DWORD  dwReserved )

inlineoverride

Definition at line 81 of file taskband.cpp.

    {
        /* We don't do anything... */
        return S_OK;
    }

ContextSensitiveHelp()

STDMETHODIMP CTaskBand::ContextSensitiveHelp ( IN BOOL  fEnterMode )

inlineoverride

Definition at line 67 of file taskband.cpp.

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

Exec()

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

inlineoverride

Implements IOleCommandTarget.

Definition at line 170 of file taskband.cpp.

    {
        if (IsEqualIID(*pguidCmdGroup, IID_IBandSite))
        {
            return S_OK;
        }
 
        if (IsEqualIID(*pguidCmdGroup, IID_IDeskBand))
        {
            return S_OK;
        }
 
        UNIMPLEMENTED;
        return E_NOTIMPL;
    }

GetBandInfo()

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

inlineoverride

Definition at line 98 of file taskband.cpp.

    {
        TRACE("CTaskBand::GetBandInfo(0x%x,0x%x,0x%p) hWnd=0x%p\n", dwBandID, dwViewMode, pdbi, m_hWnd);
 
        if (m_hWnd != NULL)
        {
            HWND hwndToolbar = ::GetWindow(m_hWnd, GW_CHILD);
 
            /* The task band never has a title */
            pdbi->dwMask &= ~DBIM_TITLE;
 
            /* NOTE: We don't return DBIMF_UNDELETEABLE here, the band site will
                     handle us differently and add this flag for us. The reason for
                     this is future changes that might allow it to be deletable.
                     We want the band site to be in charge of this decision rather
                     the band itself! */
            /* FIXME: What about DBIMF_NOGRIPPER and DBIMF_ALWAYSGRIPPER */
            pdbi->dwModeFlags = DBIMF_VARIABLEHEIGHT;
 
            /* Obtain the button size, to be used as the minimum size */
            DWORD size = SendMessageW(hwndToolbar, TB_GETBUTTONSIZE, 0, 0);
            pdbi->ptMinSize.x = 0;
            pdbi->ptMinSize.y = GET_Y_LPARAM(size);
 
            if (dwViewMode & DBIF_VIEWMODE_VERTICAL)
            {
                pdbi->ptIntegral.x = 0;
                pdbi->ptIntegral.y = 1;
            }
            else
            {
                pdbi->ptIntegral.x = 0;
                pdbi->ptIntegral.y = GET_Y_LPARAM(size);
            }
 
            /* Ignored: pdbi->ptMaxSize.x */
            pdbi->ptMaxSize.y = -1;
 
            RECT rcToolbar;
            ::GetWindowRect(hwndToolbar, &rcToolbar);
            /* FIXME: We should query the height from the task bar object!!! */
            pdbi->ptActual.x = rcToolbar.right - rcToolbar.left;
            pdbi->ptActual.y = rcToolbar.bottom - rcToolbar.top;
 
            TRACE("H: %d, Min: %d,%d, Integral.y: %d Actual: %d,%d\n", (dwViewMode & DBIF_VIEWMODE_VERTICAL) == 0,
                pdbi->ptMinSize.x, pdbi->ptMinSize.y, pdbi->ptIntegral.y,
                pdbi->ptActual.x, pdbi->ptActual.y);
 
            return S_OK;
        }
 
        return E_FAIL;
    }

GetClassID()

STDMETHODIMP CTaskBand::GetClassID ( OUT CLSID *  pClassID )

inlineoverride

Definition at line 220 of file taskband.cpp.

    {
        TRACE("CTaskBand::GetClassID(0x%p)\n", pClassID);
        /* We're going to return the (internal!) CLSID of the task band interface */
        *pClassID = CLSID_ITaskBand;
        return S_OK;
    }

GetClient()

STDMETHODIMP CTaskBand::GetClient ( OUT IUnknown **  ppunkClient )

inlineoverride

Definition at line 201 of file taskband.cpp.

    {
        TRACE("IDeskBar::GetClient(0x%p)\n", ppunkClient);
        return E_NOTIMPL;
    }

GetSite()

STDMETHODIMP CTaskBand::GetSite ( IN REFIID  riid, OUT VOID **  ppvSite  )

inlineoverride

Definition at line 291 of file taskband.cpp.

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

GetSizeMax()

STDMETHODIMP CTaskBand::GetSizeMax ( OUT ULARGE_INTEGER *  pcbSize )

inlineoverride

Definition at line 253 of file taskband.cpp.

    {
        TRACE("CTaskBand::GetSizeMax called\n");
        /* We don't need any space for the task band */
        pcbSize->QuadPart = 0;
        return S_OK;
    }

GetWindow()

STDMETHODIMP CTaskBand::GetWindow ( OUT HWND *  phwnd )

inlineoverride

Definition at line 56 of file taskband.cpp.

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

Referenced by GetBandInfo().

Initialize()

HRESULT STDMETHODCALLTYPE CTaskBand::Initialize ( IN OUT ITrayWindow *  tray, HWND  hWndStartButton  )

inline

Definition at line 328 of file taskband.cpp.

    {
        m_Tray = tray;
        return S_OK;
    }

IsDirty()

STDMETHODIMP CTaskBand::IsDirty ( void  )

inlineoverride

Implements IPersistStream.

Definition at line 229 of file taskband.cpp.

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

IsWindowOwner()

STDMETHODIMP CTaskBand::IsWindowOwner ( HWND  hWnd )

inlineoverride

Definition at line 321 of file taskband.cpp.

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

Load()

STDMETHODIMP CTaskBand::Load ( IN IStream *  pStm )

inlineoverride

Definition at line 236 of file taskband.cpp.

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

OnPosRectChangeDB()

STDMETHODIMP CTaskBand::OnPosRectChangeDB ( IN RECT *  prc )

inlineoverride

Definition at line 208 of file taskband.cpp.

    {
        TRACE("IDeskBar::OnPosRectChangeDB(0x%p=(%d,%d,%d,%d))\n", prc, prc->left, prc->top, prc->right, prc->bottom);
        if (prc->bottom - prc->top == 0)
            return S_OK;
 
        return S_FALSE;
    }

OnWinEvent()

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

inlineoverride

Definition at line 309 of file taskband.cpp.

    {
        //UNIMPLEMENTED;
        return E_NOTIMPL;
    }

QueryStatus()

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

inlineoverride

Implements IOleCommandTarget.

Definition at line 159 of file taskband.cpp.

    {
        UNIMPLEMENTED;
        return E_NOTIMPL;
    }

ResizeBorderDW()

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

inlineoverride

Implements IDockingWindow.

Definition at line 88 of file taskband.cpp.

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

Save()

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

inlineoverride

Definition at line 244 of file taskband.cpp.

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

SetClient()

STDMETHODIMP CTaskBand::SetClient ( IN IUnknown *  punkClient )

inlineoverride

Definition at line 194 of file taskband.cpp.

    {
        TRACE("IDeskBar::SetClient(0x%p)\n", punkClient);
        return E_NOTIMPL;
    }

SetSite()

STDMETHODIMP CTaskBand::SetSite ( IUnknown *  pUnkSite )

inlineoverride

Implements IObjectWithSite.

Definition at line 264 of file taskband.cpp.

    {
        HRESULT hRet;
        HWND hwndSite;
 
        TRACE("CTaskBand::SetSite(0x%p)\n", pUnkSite);
 
        hRet = IUnknown_GetWindow(pUnkSite, &hwndSite);
        if (FAILED_UNEXPECTEDLY(hRet))
            return hRet;
 
        TRACE("CreateTaskSwitchWnd(Parent: 0x%p)\n", hwndSite);
 
        hRet = CTaskSwitchWnd_CreateInstance(hwndSite, m_Tray, IID_PPV_ARG(IUnknown, &m_TasksWnd));
        if (FAILED_UNEXPECTEDLY(hRet))
            return hRet;
 
        hRet = IUnknown_GetWindow(m_TasksWnd, &m_hWnd);
        if (FAILED_UNEXPECTEDLY(hRet))
            return hRet;
 
        m_Site = pUnkSite;
 
        return S_OK;
    }

ShowDW()

STDMETHODIMP CTaskBand::ShowDW ( IN BOOL  bShow )

inlineoverride

Definition at line 74 of file taskband.cpp.

    {
        /* We don't do anything... */
        return S_OK;
    }

Member Data Documentation

m_hWnd

HWND CTaskBand::m_hWnd

private

Definition at line 43 of file taskband.cpp.

Referenced by GetBandInfo(), GetWindow(), IsWindowOwner(), and SetSite().

m_Site

CComPtr<IUnknown> CTaskBand::m_Site

private

Definition at line 40 of file taskband.cpp.

Referenced by GetSite(), and SetSite().

m_TasksWnd

CComPtr<IUnknown> CTaskBand::m_TasksWnd

private

Definition at line 41 of file taskband.cpp.

Referenced by SetSite().

m_Tray

CComPtr<ITrayWindow> CTaskBand::m_Tray

private

Definition at line 39 of file taskband.cpp.

Referenced by Initialize(), and SetSite().

---

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

• base/shell/explorer/taskband.cpp