DeskBand实现之——实现声明

本文列出Desk Band的具体实现细节与代码。

我这个Desk Band都是用SDK直接实现，没有用ATL来实现，用ATL也是可以的。用SDK可能麻烦一点。

 

SdkDeskBandObject.h文件

说明：SdkDeskBandObject这个类定义了Band对象的接口。

#ifdef __cplusplus
#ifndef _SDKDESKBANDDEF_H_
#define _SDKDESKBANDDEF_H_
#include "SdkCommonHelper.h"
#include "IDeskBandWindow.h"


class SdkDeskBandObject : public IDeskBand2,
                          public IPersistStream,
                          public IInputObject,
                          public IObjectWithSite
{
public:
    SdkDeskBandObject(void);
    // IUnknown
    STDMETHODIMP QueryInterface(REFIID riid, void** ppv);
    STDMETHODIMP_(ULONG) AddRef();
    STDMETHODIMP_(ULONG) Release();
    // IOleWindow
    STDMETHODIMP GetWindow(HWND *phwnd);
    STDMETHODIMP ContextSensitiveHelp(BOOL fEnterMode);
    // IDockingWindow
    STDMETHODIMP ShowDW(BOOL fShow);
    STDMETHODIMP CloseDW(DWORD dwReserved);
    STDMETHODIMP ResizeBorderDW(LPCRECT prcBorder, 
                 IUnknown *punkToolbarSite, BOOL fReserved);
    // IDeskBand (needed for all desk bands)
    STDMETHODIMP GetBandInfo(DWORD dwBandID, 
                 DWORD dwViewMode, DESKBANDINFO *pdbi);
    // IDeskBand2 (needed for glass desk band)
    STDMETHODIMP CanRenderComposited(BOOL *pfCanRenderComposited);
    STDMETHODIMP SetCompositionState(BOOL fCompositionEnabled);
    STDMETHODIMP GetCompositionState(BOOL *pfCompositionEnabled);
    // IPersist
    STDMETHODIMP GetClassID(CLSID *pclsid);
    // IPersistStream
    STDMETHODIMP IsDirty();
    STDMETHODIMP Load(IStream *pStm);
    STDMETHODIMP Save(IStream *pStm, BOOL fClearDirty);
    STDMETHODIMP GetSizeMax(ULARGE_INTEGER *pcbSize);
    // IObjectWithSite
    STDMETHODIMP SetSite(IUnknown *pUnkSite);
    STDMETHODIMP GetSite(REFIID riid, void **ppv);
    // IInputObject
    STDMETHODIMP UIActivateIO(BOOL fActivate, MSG *pMsg);
    STDMETHODIMP HasFocusIO();
    STDMETHODIMP TranslateAcceleratorIO(MSG *pMsg);
 
    BOOL OnSetFocus(BOOL fSetFocus);
    BOOL IsVerticalViewMode();
protected:
    ~SdkDeskBandObject(void);
private:
    // Whether desk band has focus
    BOOL                m_fHasFocus;  
    // Whether desk band setting has changed          
    BOOL                m_fIsDirty;   
    // Whether glass is currently enabled in desk band          
    BOOL                m_fCompositionEnabled;  
    // The view mode of the band object
    DWORD               m_dwViewMode;   
    // The ID of desk band        
    DWORD               m_dwBandID;  
    // The reference count of CDeskBandObject           
    volatile LONG       m_lRefCount;    
    // The desk band window object        
    IDeskBandWindow    *m_pDeskBandWin;  
    // Parent site that contains desk band       
    IInputObjectSite   *m_pInputObjSite;        
};
#endif // _SDKDESKBANDDEF_H_
#endif // __cplusplus

注意：CDeskBandOjbect依赖于IDeskBandWindow（定义请参见下面）这个接口去管理窗体，包括创建，显示或隐藏，关闭等操作。这个接口的实现从哪里来呢？可以再实现一个类似于类工厂的类，创建一个IDeskBandWindow接口类型的指针，所有的初始化操作都放在类工厂中去做。这样做的好处是CDeskBandOjbect不依赖于具体类。

SdkClassFactory.h文件

说明：这个类实现了IClassFactory接口，CreateInstance会创建出SdkDeskBandObject对象。

#ifdef __cplusplus
#ifndef _CLASSFACTORY_H_
#define _CLASSFACTORY_H_
#include "SdkCommonHelper.h"
 
class SdkClassFactory : public IClassFactory
{
public:
    SdkClassFactory(void);
    STDMETHODIMP QueryInterface(REFIID riid, void **ppv);
    STDMETHODIMP_(ULONG) AddRef();
    STDMETHODIMP_(ULONG) Release();
 
    // IClassFactory
    STDMETHODIMP CreateInstance(IUnknown *pUnkOuter, REFIID riid, void **ppv);
    STDMETHODIMP LockServer(BOOL fLock);
protected:
    ~SdkClassFactory(void);
private:
    volatile LONG    m_lRefCount;    // The reference count of current class.
};
#endif // _CLASSFACTORY_H_
#endif //__cplusplus

IDeskBandWIndow.h文件

说明：这是一个接口，定义了一系列实现一个窗体的接口，这样，BAND对象依赖于这个接口，而不依赖于具体实现类。

#ifdef __cplusplus
#ifndef _IDESKBANDWINDOW_H_
#define _IDESKBANDWINDOW_H_
#include "SdkCommon.h"
 
class IDeskBandWindow
{
public:
    virtual BOOL CreateDeskBand(HWND hParentWnd, HINSTANCE hInstance, LPVOID pData) = 0;
    virtual BOOL ShowDeskBand(BOOL fShowOrHide = TRUE) = 0;
    virtual void CloseDeskBand() = 0;
    virtual HWND GetDeskBandHandle() = 0;
    virtual SIZE GetDeskBandMinSize(BOOL fNormalViewMode = TRUE) = 0;
    virtual void RefreshDeskBand() = 0;
};
#endif // _IDESKBANDWINDOW_H_
#endif // __cplusplus

SdkDeskBandDef.h文件

说明：这个文件定义了DeskBand共通的常量

#ifdef __cplusplus
#ifndef _SDKDESKBANDDEF_H_
#define _SDKDESKBANDDEF_H_
#include <Windows.h>
 
//
//
// The global variables
//


#ifdef _DEFINE_GLOBAL_VARIABLES
// A handle to the DLL module. The value is the base address of the Dll.
HINSTANCE g_hDllInst        = NULL;  
// The reference count of the Dll.
LONG      g_lDllRefCount    = 1;      
#else
// A handle to the DLL module. The value is the base address of the Dll.
extern HINSTANCE g_hDllInst;  
// The reference count of the Dll.
extern LONG      g_lDllRefCount;                
#endif // _DEFINE_GLOBAL_VARIABLES
 


//
//
// The constant variable
//
 
// {DAF82547-D986-4f30-AF80-24CC3577D6EB}
const CLSID CLSID_SdkDeskBand = { 
                0xdaf82547, 0xd986, 0x4f30, 
                { 0xaf, 0x80, 0x24, 0xcc, 0x35, 0x77, 0xd6, 0xeb } };

未完待续，下一篇我将给出一些具体实现细节和代码。