开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 数值算法/人工智能 > 生物技术 > 查看源码
menu_window.hpp
资源名称：ncbi_cxx_win--Jul_08_2004.zip　[点击查看]
上传用户：yhdzpy8989
上传日期：2007-06-13
资源大小：13604k
文件大小：13k
源码类别：

生物技术

开发平台：

C/C++

menu_window.hpp：源码内容
  1. /*
  2.  * ===========================================================================
  3.  * PRODUCTION $Log: menu_window.hpp,v $
  4.  * PRODUCTION Revision 1000.0  2004/06/01 19:56:37  gouriano
  5.  * PRODUCTION PRODUCTION: IMPORTED [GCC34_MSVC7] Dev-tree R1.5
  6.  * PRODUCTION
  7.  * ===========================================================================
  8.  */
  10. #ifndef GUI_WIDGETS_FL___MENU_WINDOW__HPP
  11. #define GUI_WIDGETS_FL___MENU_WINDOW__HPP
  13. /*  $Id: menu_window.hpp,v 1000.0 2004/06/01 19:56:37 gouriano Exp $
  14.  * ===========================================================================
  15.  *
  16.  *                            PUBLIC DOMAIN NOTICE
  17.  *               National Center for Biotechnology Information
  18.  *
  19.  *  This software/database is a "United States Government Work" under the
  20.  *  terms of the United States Copyright Act.  It was written as part of
  21.  *  the author's official duties as a United States Government employee and
  22.  *  thus cannot be copyrighted.  This software/database is freely available
  23.  *  to the public for use. The National Library of Medicine and the U.S.
  24.  *  Government have not placed any restriction on its use or reproduction.
  25.  *
  26.  *  Although all reasonable efforts have been taken to ensure the accuracy
  27.  *  and reliability of the software and data, the NLM and the U.S.
  28.  *  Government do not and cannot warrant the performance or results that
  29.  *  may be obtained by using this software or data. The NLM and the U.S.
  30.  *  Government disclaim all warranties, express or implied, including
  31.  *  warranties of performance, merchantability or fitness for any particular
  32.  *  purpose.
  33.  *
  34.  *  Please cite the author in any work or product based on this material.
  35.  *
  36.  * ===========================================================================
  37.  *
  38.  * Authors:  Andrey Yazhuk
  39.  *
  40.  */
  42. /// @file menu.hpp
  43.  
  44. #include <corelib/ncbistd.hpp>
  45. #include <corelib/ncbi_tree.hpp>
  47. #include <gui/utils/command.hpp>
  48. #include <gui/utils/gui_event.hpp>
  50. #include <gui/widgets/fl/rect.hpp>
  51. #include <gui/widgets/fl/menu_item.hpp>
  52. #include <gui/widgets/fl/resource_manager.hpp>
  53. #include <gui/widgets/fl/tooltip.hpp>
  54. #include <gui/widgets/fl/fltk_timer.hpp>
  56. #include <FL/Fl_Menu_.H>
  57. #include <FL/Fl_Menu_Item.H>
  58. #include <FL/Fl_Double_Window.H>
  59. #include <FL/Fl_Image.H>
  61. /** @addtogroup GUI_FltkWidgets
  62.  *
  63.  * @{
  64.  */
  66. BEGIN_NCBI_SCOPE
  68. ///////////////////////////////////////////////////////////////////////////////
  69. ///
  70. class NCBI_GUIWIDGETS_FL_EXPORT IMenuHintListener
  71. {
  72. public:
  73.     virtual ~IMenuHintListener()    {};
  75.     virtual void    OnHint(const string& hint) = 0;
  76. };
  78. ///////////////////////////////////////////////////////////////////////////////
  79. /// class CMenu - base class for all menus
  80. ///
  81. /// Access key is underlined letter in the menu item label. When a menu is active,
  82. /// the user can select a menu item by pressing the key that corresponds to the 
  83. /// item's underlined letter. 
  84. /// Accelerator is a combination of key with a number of modifiers corresponding 
  85. /// to a command. Menu shows accelerator labels next to corresponding command items.
  86. ///
  87. class NCBI_GUIWIDGETS_FL_EXPORT CMenu : public IMenu
  88. {
  89. public:
  90.     enum    EColorType  {
  91.         eBack = 0,
  92.         eFocusedBack,
  93.         eCheckedBack,
  94.         ePushedBack,
  95.         ePopupBack,
  96.         eFrame,
  97.         eText,
  98.         eDisabledText,
  99.         eFocusedDisabledText,
  100.         ePushedText,
  101.         eFocusedFrame,
  102.         eIconArea,
  103.         eBorder,
  104.         eLast
  105.     };
  107.     /// CProperties holds common properties for all CMenu derived classes;
  108.     class CProperties
  109.     {    
  110.     public:
  111.         CProperties(void);
  112.         inline  Fl_Color    GetColor(EColorType type)   const   {   return m_Colors[type];  } 
  114.     public:
  115.         int m_FontType;
  116.         int m_FontSize;
  117.     
  118.         Fl_Color    m_Colors[eLast];
  119.     };
  121. public:
  122.     CMenu(void);
  123.     virtual ~CMenu(void);
  125.     static  CRef<CResourceManager>      GetResourceManager(void);
  126.     static  void    SetResourceManager(CRef<CResourceManager> manager);
  127.     
  128.     static  void    SetCmdHint(TCmdID cmd, const string& hint);
  129.     static  string  GetCmdHint(TCmdID cmd);
  131.     /// @name IMenu* implementation
  132.     /// @{
  133.     virtual void    SetCmdTarget(CCommandTarget* target);
  134.     virtual CCommandTarget*    GetCmdTarget(void);
  135.     /// @}
  137.     virtual void    SetItemImageSize(int size);
  139.     virtual void    SetItems(const SMenuItemRec* items);
  140.     virtual void    SetItems(CMenuItem* root_item); // takes ownership of the given structure
  142.     virtual void    SetHintListener(IMenuHintListener* listener);
  143.     virtual IMenuHintListener*  GetHintListener();
  144.     
  145.     virtual CPoint  GetPreferredSize(void) const;
  146.     virtual void    SetSelected(CMenuItem* item);
  147.     
  148.     CMenuItem*      GetRootItem(void);
  149.     int             GetBorder(void) const;
  151.     /// returns pointer to widget hosting CMenu instance
  152.     virtual Fl_Widget&        GetWidget(void) = 0;
  153.     virtual const Fl_Widget&  GetWidget(void) const = 0;
  154.     
  155.     bool    x_IsSubMenuPushed() const   {   return m_PushedItem  && m_PushedItem->IsSubmenu();  }
  156.     bool    x_IsItemPushed() const   {   return m_PushedItem  && m_PushedItem->IsItem();  }
  158. protected:
  159.     struct  SItemEntry  
  160.     {
  161.         CMenuItem*  m_Item;
  162.         CFLTKImageHandle    m_hIcon;
  163.         int         m_Size;
  164.         string      m_AccelLabel; // symbolic representation of accelerator
  165.     };
  166.     
  167. protected:    
  168.     virtual bool    x_IsKeyActivated() const;
  170.     virtual void    x_SetItems(CMenuItem* root_item, bool take_ownership);
  171.     virtual void    x_Clear(void);
  172.     virtual void    x_Layout(void);
  173.     virtual void    x_UpdateItems(void);
  174.     
  175.     virtual void    x_Draw(int x, int y);
  176.     virtual void    x_DrawItems(int x, int y);
  177.     virtual void    x_ExecuteCommand(const CMenuItem& item);
  178.     
  179.     virtual bool    x_IsHorizontal(void)  const = 0;
  180.     
  181.     virtual void    x_MeasureItem(const SItemEntry& entry, int& text_w) const;
  182.     virtual void    x_DrawItem(SItemEntry& entry, int x, int y, int w, int h);
  183.     virtual void    x_DrawItemText(const SItemEntry& entry, int x, int y, int w, int h);
  184.     virtual void    x_DrawItemIcon(SItemEntry& entry, int x, int y, Fl_Color back_color);
  185.     CMenuItem*      x_HitTest(int x, int y);
  187.     // returns rectangle used to position submenu
  188.     virtual CRect   x_GetPopupItemRect(const CMenuItem& item);
  189.     
  190. protected:  
  191.     typedef vector<SItemEntry>      TEntries;
  192.     typedef map<char, CMenuItem*>   TAccessKeyToItemMap; 
  193.     typedef map<TCmdID, string>     TCmdToHintMap;
  194.     
  195.     static  CProperties         sm_Props; // common properties for all menus
  196.     static  CRef<CResourceManager>   sm_ResManager; // singleton Resource Manager
  197.     static  TCmdToHintMap       sm_CmdToHint;
  198.       
  199.     CMenuItem*  m_RootItem;
  200.     bool        m_bOwnItems;  /// if "true" CMenu does not assume ownership of m_RootItem
  201.     
  202.     CCommandTarget*     m_CmdTarget; /// root command target
  203.     IMenuHintListener*   m_Listener;
  205.     TEntries            m_Entries;  /// menu item entires
  206.     TAccessKeyToItemMap m_AccessKeyToItem; /// access key table
  207.     
  208.     int     m_Width;  // total width including borders
  209.     int     m_Height; // total height including borders 
  210.     int     m_Border; // width(height) of the border around menu items
  211.     int     m_IconSize;
  212.     int     m_MaxLabelW;
  213.     EColorType  m_BackColor;
  214.     
  215.     CMenuItem*  m_Selected; // selected (focused) item
  216.     CMenuItem*  m_PushedItem; // item pushed by mouse or keyboard
  217.     bool        m_bKeyActivated; // menu was activated using keyboard
  218.     
  219.     CFLTKImageHandle    m_hCheckIcon;
  220.     CFLTKImageHandle    m_hRadioIcon;
  221. };
  224. ///////////////////////////////////////////////////////////////////////////////
  225. /// CMenuCmdUI
  227. class NCBI_GUIWIDGETS_FL_EXPORT CMenuCmdUI : public ICmdUI
  228. {
  229. public:
  230.     CMenuCmdUI(CMenuItem& item);
  232.     /// @name ICmdUI implementation
  233.     /// @{
  234.     virtual TCmdID  GetCommand() const;
  235.     virtual void    Enable(bool en);
  236.     virtual void    SetCheck(bool set);
  237.     virtual void    SetRadio(bool set);
  238.     virtual void    SetLabel(const string& label);
  239.     /// @}
  241. protected:
  242.     CMenuItem& m_Item;
  243. };
  246. ///////////////////////////////////////////////////////////////////////////////
  247. /// CPopupMenu1
  248. typedef Fl_Double_Window    TPopupMenuParent;
  250. class  NCBI_GUIWIDGETS_FL_EXPORT CPopupMenu1 :  public TPopupMenuParent,
  251.                                                 public CMenu,
  252.                                                 public ITimerListener 
  253. {    
  254.     friend class CMenuBar1;
  255. public:    
  256.     CPopupMenu1(int x, int y, CMenuItem* root_item, CCommandTarget* target = NULL,
  257.                 IMenuHintListener* listener = NULL);
  258.     CPopupMenu1(int x, int y, const SMenuItemRec* items, CCommandTarget* target = NULL,
  259.                 IMenuHintListener* listener = NULL);
  261. protected:
  262.     /// Creates a child popup menu
  263.     CPopupMenu1(int x, int y, int left, int top, CMenuItem* root_item,
  264.                 CCommandTarget* target, IMenuHintListener* listener);
  265.     
  266.     /// Creates root popup menu stub for a menubar
  267.     CPopupMenu1(CMenuBar1& menubar, CMenuItem* root_item, CMenuItem* sel_item,
  268.                 IMenuHintListener* listener);
  270. public:        
  271.     virtual void    Popup(void); /// shows popup menu
  273.     /// @name FLTK overridables
  274.     /// @{
  275.     virtual void    show(void);
  276.     virtual void    draw(void);
  277.     virtual int     handle(int event);
  278.     /// @}
  279.     
  280.     virtual void    OnTimeout(int timer_id);
  282.     virtual Fl_Widget&        GetWidget(void);
  283.     virtual const Fl_Widget&  GetWidget(void) const;
  285. protected:
  286.     virtual void    x_Init(int x, int y, int left, int top, CMenuItem* root_item,
  287.                            CCommandTarget* target, IMenuHintListener* listener, bool root_popup);
  289.     virtual bool    x_IsHorizontal() const;   
  290.     virtual void    SetSelected(CMenuItem* item);
  292.     virtual CRect   x_GetPopupItemRect(const CMenuItem& item);
  294.     void    x_CollapseToCurrent(void);
  295.     void    x_ShowCurrItemSubmenu(bool b_select);
  296.     void    x_TogglePushItem();
  297.     
  298.     int     x_HandleKeyboard(void);
  299.     int     x_HandleShortcuts(void);
  301.     void    x_OnLeftPressed(void);
  302.     void    x_OnRightPressed(void);
  304.     void    x_SelectNextItem(void);
  305.     void    x_SelectPrevItem(void);
  306.     void    x_SelectTopItem(void);
  307.     void    x_SelectBottomItem(void);
  308.     
  309.     void    x_CloseItemSubmenu(void);
  311.     void    x_SetExecuteCommand(const CMenuItem& item);
  312.     void    x_UpdateListener();
  313.     
  314.     void    x_AdjustRectangle(void); // adjust window size and position
  315.     bool    x_IsMenuBar() const {   return m_MenuBar != NULL;   }
  317. protected:
  318.     int     m_Left;
  319.     int     m_Top;
  320.     CMenuBar1*  m_MenuBar;
  321.     bool        m_bSkipFirstRelease;
  322.     TCmdID      m_Cmd; // choosen command
  323.     CFLTKTimer  m_Timer;
  324.     CGUIEvent   m_Event;
  326. protected:
  327.     enum    EState{ 
  328.         eIdle, 
  329.         eTrack, // track item, do not expand submenus
  330.         eTrackSubmenus, // track item, show/hide submenus
  331.         eExpand, // selected item
  332.         eHide, // hide the last popup        
  333.         eMenuPush, // push on submenu
  334.         ePush,     // push on command item         
  335.         eDone   
  336.     };
  337.     typedef vector<CPopupMenu1*> TPopupVector;
  338.     static  TPopupVector    sm_Popups;
  339.     static  CMenuItem*      sm_CurrItem;
  340.     static  CPopupMenu1*    sm_CurrPopup;
  341.     static  EState          sm_State;
  342.     static  bool            sm_bMenubar;    
  343. };
  346. ///////////////////////////////////////////////////////////////////////////////
  347. /// CMenuBar1
  348. class NCBI_GUIWIDGETS_FL_EXPORT CMenuBar1 : 
  349.         public Fl_Widget, 
  350.         public CMenu,
  351.         public ITooltipClient        
  352. {
  353.     friend class CPopupMenu1;
  354. public:
  355.     CMenuBar1(int x, int y, int w, int h);
  357.     virtual void    EnableTooltips(bool b_en);
  359.     // update items state
  360.     virtual void    UpdateItems()   {   x_UpdateItems();    }
  362.     virtual void    Activate();
  364.     /// @name FLTK overridables
  365.     /// @{
  366.     virtual void    draw(void);
  367.     virtual int     handle(int event);
  368.     /// @}
  369.     
  370.     CRect   GetPopupRect() const;
  372.     /// @name ITooltipClient implementation
  373.     /// @{
  374.     virtual bool    TC_NeedTooltip(int x, int y);  
  375.     virtual string  TC_GetTooltip(int& x, int& y, int& w, int& h);
  376.     /// @}
  378.     virtual Fl_Widget&        GetWidget(void);
  379.     virtual const Fl_Widget&  GetWidget(void) const;
  380. protected:
  381.     virtual void    x_Draw(int x, int y);
  382.     virtual int     x_Handle(int event);
  383.     
  384.     int     x_HandleShortcuts(void);
  385.     void    x_ShowSubMenu(void);
  387.     virtual bool    x_IsHorizontal() const;   
  389.     virtual string  x_GetTooltip(const CMenuItem& item) const;
  391. protected:
  392.     CTooltip    m_Tooltip;
  393.     CMenuItem*  m_TooltipItem;    
  394. };
  397. END_NCBI_SCOPE
  399. /* @} */
  401. /*
  402.  * ===========================================================================
  403.  * $Log: menu_window.hpp,v $
  404.  * Revision 1000.0  2004/06/01 19:56:37  gouriano
  405.  * PRODUCTION: IMPORTED [GCC34_MSVC7] Dev-tree R1.5
  406.  *
  407.  * Revision 1.5  2004/05/13 17:29:30  yazhuk
  408.  * Added support for accelerators, keyboard activated menus
  409.  *
  410.  * Revision 1.4  2004/05/11 18:55:14  dicuccio
  411.  * Added doxygen modules info
  412.  *
  413.  * Revision 1.3  2004/05/07 14:19:04  yazhuk
  414.  * Added UpdateItems()
  415.  *
  416.  * Revision 1.2  2004/05/03 19:47:27  yazhuk
  417.  * Refactoring; support for command updates
  418.  *
  419.  * Revision 1.1  2004/04/22 16:53:18  yazhuk
  420.  * Initial revision: menu_window.hpp
  421.  *
  422.  * ===========================================================================
  423.  */
  425. #endif  // GUI_WIDGETS_FL___MENU_WINDOW__HPP