uicoolmenu.h

vc座的资源管理器源代码

////////////////////////////////////////////////////////////////
// 199 Microsoft Systems Journal. 
// If this code works, it was written by Paul DiLascia.
// If not, I don't know who wrote it.
//
// ==========================================================================  
// HISTORY:   
// ==========================================================================  
//      1.01    13 Aug 1998 - Andrew Bancroft [[e-mail]] - Since we've already 
//                            added the entire toolbar to the imagelist we need to 
//                            increment nNextImage even if we didn't add this button to 
//                            m_mapIDtoImage in the LoadToolbar() method.
//      1.01a   13 Aug 1998 - Peter Tewkesbury - Added AddSingleBitmap(...)
//                            method for adding a single bitmap to a pulldown
//                            menu item.
//      1.02    13 Aug 1998 - Omar L Francisco - Fixed bug with lpds->CtlType
//                            and lpds->itemData item checking.
//      1.03    12 Nov 1998 - Fixes debug assert in system menu. - Wang Jun
//      1.04    17 Nov 1998 - Fixes debug assert when you maximize a view - Wang Jun
//                            window, then try to use the system menu for the view.
//      1.05    09 Jan 1998 - Seain B. Conover [[e-mail]] - Fix for virtual 
//                            key names.
//      1.06    24 Feb 1999 - Michael Lange [[e-mail]] - Fix for memory 
//                            leak in CMyItemData structure, added a destructor that 
//                            calls text.Empty().
//                          - Boris Kartamishev [[e-mail]] - Fix for resource
//                            ID bug.
//                          - Jeremy Horgan [[e-mail]] - During 
//                            accelerator key processing OnInitMenuPopup() calls 
//                            ConvertMenu() which allocates a new CMyItemData for each 
//                            menu item. This is memory is normally freed by a call to 
//                            OnMenuSelect(), which is not called when processing 
//                            accelerator keys. This results in a memory leak. This was
//                            fixed by modifying the ~CCoolMenuManager() destructor.
//      1.07    24 Feb 1999 - Koji MATSUNAMI [[e-mail]] - Fixed problem with 
//                            popup menus being drawn correctly as cool menus.
// ==========================================================================
//
/////////////////////////////////////////////////////////////////////////////

#ifndef __COOLMENU_H__
#define __COOLMENU_H__

#include "UISubClass.h"

//////////////////
// CCoolMenuManager implements "cool" menus with buttons in them. To use:
//
//  *   Instantiate in your CMainFrame.
//   * Call Install to install it
//  * Call LoadToolbars or LoadToolbar to load toolbars
//
//  Don't forget to link with CoolMenu.cpp, Subclass.cpp and DrawTool.cpp!
//
class CTRL_EXT_CLASS CCoolMenuManager : public CSubclassWnd 
{
public:
    DECLARE_DYNAMIC(CCoolMenuManager)
    CCoolMenuManager();
    ~CCoolMenuManager();

    // You can set these any time
    BOOL m_bShowButtons;            // use to control whether buttons are shown
    BOOL m_bAutoAccel;          // generate auto accelerators
    BOOL m_bUseDrawState;       // use ::DrawState for disabled buttons
    BOOL m_bDrawDisabledButtonsInColor; // draw disabled buttons in color
                                                    // (only if m_bUseDrawState = FALSE)

    // public functions to use
    void Install(CWnd* pFrame);                 // connect to main frame
    void Uninstall();                 // disconnect from main frame
    BOOL LoadToolbars(const UINT* arIDs, int n);    // load multiple toolbars
    BOOL LoadToolbar(UINT nID);                     // load one toolbar
	CSize SetButtonSize(CSize &sz=CSize(0,0));				// Set up button sizes if not using toolbar
    BOOL AddSingleBitmap(UINT nBitmapID, UINT n, UINT *nID);

    // O.S. - item access
    static void *SetItemData(HMENU hMenu, void *pData, UINT uItem, BOOL bByPosition = FALSE);
    static void *GetItemData(HMENU hMenu, UINT uItem, BOOL bByPosition = FALSE);
    static HICON SetItemIcon(HMENU hMenu, HICON hIcon, UINT uItem, BOOL bByPosition = FALSE);
    static HICON GetItemIcon(HMENU hMenu, UINT uItem, BOOL bByPosition = FALSE);

    // O.S. -- stuff for submenus
    void SetSubMenuIcon(HMENU hSubMenu, int nID); // nID == -1 -> never convert this submenu
    void UnmanageSubMenu(HMENU hSubMenu);
	// shell menu functions
	void SetShellContextMenu(LPCONTEXTMENU lpcm,UINT nIDFirst,UINT nIDLast);
	void AddShellContextMenu(CMenu *pMenu, LPCONTEXTMENU lpm, int iIndex);
    // Conversion routines
	// Switch between MyItemData and their item data
	DWORD SwitchContextItemData(CMenu *pMenu, int iCmd, DWORD dwItemData=0, BOOL bByPosition=TRUE);
    void ConvertMenu(CMenu *pMenu);
    void UnconvertMenu(CMenu *pMenu);
    void ConvertMenuItem(CMenu *pMenu, int iIndex, bool bRecurse = true, 
        bool bUnconvert = false);

    // should never need to call:
    virtual void Destroy(); // destroys everything--to re-load new toolbars?
    virtual void Refresh(); // called when system colors, etc change
    static  HBITMAP GetMFCDotBitmap();  // get..
    static  void    FixMFCDotBitmap();  // and fix MFC's dot bitmap

    static BOOL bTRACE; // Set TRUE to see extra diagnostics in DEBUG code

protected:
    CWnd*       m_pFrame;       // frame window I belong to
    CUIntArray      m_arToolbarID;  // array of toolbar IDs loaded
    CImageList      m_ilButtons;    // image list for all buttons
    CImageList      m_ilTemp;       // image list for all buttons
    CMapWordToPtr   m_mapIDtoImage;// maps command ID -> image list index
    CMapWordToPtr   m_mapIDtoAccel;// maps command ID -> ACCEL*
    CMapPtrToWord   m_mapHMENUtoID; 
    HACCEL          m_hAccel;       // current accelerators, if any
    ACCEL*          m_pAccel;       // ..and table in memory
    CPtrList            m_menuList;     // list of HMENU's initialized
    CSize               m_szBitmap;     // size of button bitmap
    CSize               m_szButton;     // size of button (including shadow)
    CFont               m_fontMenu;     // menu font
	///////////////////////////
	// Addition: Philip Oldaker
	// Shell helpers to show help string on the status bar
	UINT			m_idShellMenuFirst;
	UINT			m_idShellMenuLast;
	LPCONTEXTMENU	m_lpcm;
	//////////////////////////
    void ConvertMenu(CMenu* pMenu,UINT nIndex,BOOL bSysMenu,BOOL bShowButtons);

    // helpers
    void DestroyAccel();
    void DrawMenuText(CDC& dc, CRect rc, CString text, COLORREF color);
    BOOL Draw3DCheckmark(CDC& dc, const CRect& rc, BOOL bSelected,
                HBITMAP hbmCheck=NULL);
    void LoadAccel(HACCEL hAccel);
    CString GetVirtualKeyName( const CString strVirtKey ) const;
    BOOL AppendAccelName(CString& sItemName, UINT nID);
    CFont* GetMenuFont();

    // Get button index for given command ID, or -1 if not found
    int  GetButtonIndex(WORD nID) {
        void* val;
        return m_mapIDtoImage.Lookup(nID, val) ? (int)val : -1;
    }

    // Get ACCEL structure associated with a given command ID
    ACCEL* GetAccel(WORD nID) {
        void* val;
        return m_mapIDtoAccel.Lookup(nID, val) ? (ACCEL*)val : NULL;
    }

    // window proc to hook frame using CCoolMenuSubclassWnd implementation
    virtual LRESULT WindowProc(UINT msg, WPARAM wp, LPARAM lp);

    // CCoolMenuSubclassWnd message handlers 
    virtual void OnInitMenuPopup(CMenu* pMenu, UINT nIndex, BOOL bSysMenu);
    virtual BOOL OnMeasureItem(LPMEASUREITEMSTRUCT lpms);
    virtual BOOL OnDrawItem(LPDRAWITEMSTRUCT lpds);
    virtual LONG OnMenuChar(UINT nChar, UINT nFlags, CMenu* pMenu);
    virtual void OnMenuSelect(UINT nItemID, UINT nFlags, HMENU hSysMenu);
};

// the one and only manager
extern CCoolMenuManager g_CoolMenuManager;

//////////////////
// Friendly version of MENUITEMINFO initializes itself
//
struct CMenuItemInfo : public MENUITEMINFO {
    CMenuItemInfo()
    { memset(this, 0, sizeof(MENUITEMINFO));
      cbSize = sizeof(MENUITEMINFO);
    }
};

#endif // __COOLMENU_H__