include/wx/gtk/menu.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        menu.h
   3 // Purpose:
   4 // Author:      Robert Roebling
   5 // Id:          $Id$
   6 // Copyright:   (c) 1998 Robert Roebling, Julian Smart
   7 // Licence:     wxWindows licence
   8 /////////////////////////////////////////////////////////////////////////////
   9
  10
  11 #ifndef __GTKMENUH__
  12 #define __GTKMENUH__
  13
  14 #ifdef __GNUG__
  15 #pragma interface
  16 #endif
  17
  18 #include "wx/defs.h"
  19 #include "wx/object.h"
  20 #include "wx/list.h"
  21 #include "wx/window.h"
  22 #include "wx/menuitem.h"
  23
  24 //-----------------------------------------------------------------------------
  25 // classes
  26 //-----------------------------------------------------------------------------
  27
  28 class wxMenuBar;
  29 class wxMenuItem;
  30 class wxMenu;
  31
  32 //-----------------------------------------------------------------------------
  33 // const
  34 //-----------------------------------------------------------------------------
  35
  36 #define   ID_SEPARATOR    (-1)
  37
  38 //-----------------------------------------------------------------------------
  39 // wxMenuBar
  40 //-----------------------------------------------------------------------------
  41
  42 class wxMenuBar: public wxWindow
  43 {
  44 DECLARE_DYNAMIC_CLASS(wxMenuBar)
  45
  46 public:
  47   wxMenuBar( long style );
  48   wxMenuBar();
  49   void Append( wxMenu *menu, const wxString &title );
  50
  51   int FindMenuItem( const wxString &menuString, const wxString &itemString ) const;
  52   wxMenuItem* FindMenuItemById( int id ) const;
  53   inline wxMenuItem* FindItemForId( int id ) const { return FindMenuItemById( id ); }
  54
  55   void Check( int id, bool check );
  56   bool Checked( int id ) const;
  57   void Enable( int id, bool enable );
  58   bool Enabled( int id ) const;
  59   inline bool IsEnabled( int id ) const { return Enabled(id); }
  60   inline bool IsChecked( int id ) const { return Checked(id); }
  61
  62   wxString GetLabel( int id ) const;
  63   void SetLabel( int id, const wxString &label );
  64
  65   void EnableTop( int pos, bool flag );
  66   void SetLabelTop( int pos, const wxString& label );
  67   wxString GetLabelTop( int pos ) const;
  68
  69   virtual void SetHelpString( int id, const wxString& helpString );
  70   virtual wxString GetHelpString( int id ) const;
  71
  72   inline int GetMenuCount() const { return m_menus.Number(); }
  73   inline wxMenu *GetMenu( int n ) const { return (wxMenu *)m_menus.Nth(n)->Data(); }
  74
  75   wxList       m_menus;
  76   GtkWidget   *m_menubar;
  77 };
  78
  79 //-----------------------------------------------------------------------------
  80 // wxMenu
  81 //-----------------------------------------------------------------------------
  82
  83 class wxMenu: public wxEvtHandler
  84 {
  85 DECLARE_DYNAMIC_CLASS(wxMenu)
  86
  87 public:
  88   // construction
  89   wxMenu( const wxString& title = wxEmptyString, const wxFunction func = (wxFunction) NULL );
  90
  91   // operations
  92     // title
  93   void SetTitle(const wxString& label);
  94   const wxString GetTitle() const;
  95     // menu creation
  96   void AppendSeparator();
  97   void Append(int id, const wxString &item,
  98               const wxString &helpStr = "", bool checkable = FALSE);
  99   void Append(int id, const wxString &item,
 100               wxMenu *subMenu, const wxString &helpStr = "" );
 101   void Break() {};
 102
 103     // find item by name/id
 104   int FindItem( const wxString itemString ) const;
 105   wxMenuItem *FindItem( int id ) const;
 106   wxMenuItem *FindItemForId( int id ) const { return FindItem( id ); }
 107
 108     // get/set item's state
 109   void Enable( int id, bool enable );
 110   bool IsEnabled( int id ) const;
 111   void Check( int id, bool check );
 112   bool IsChecked( int id ) const;
 113
 114   void SetLabel( int id, const wxString &label );
 115   wxString GetLabel( int id ) const;
 116
 117   // helpstring
 118   virtual void SetHelpString(int id, const wxString& helpString);
 119   virtual wxString GetHelpString(int id) const ;
 120
 121   // accessors
 122   wxList& GetItems() { return m_items; }
 123
 124   inline void Callback(const wxFunction func) { m_callback = func; }
 125
 126   inline void SetEventHandler(wxEvtHandler *handler) { m_eventHandler = handler; }
 127   inline wxEvtHandler *GetEventHandler() { return m_eventHandler; }
 128
 129   inline void SetClientData( void* clientData ) { m_clientData = clientData; }
 130   inline void* GetClientData() const { return m_clientData; }
 131
 132   // Updates the UI for a menu and all submenus recursively.
 133   // source is the object that has the update event handlers
 134   // defined for it. If NULL, the menu or associated window
 135   // will be used.
 136   void UpdateUI(wxEvtHandler* source = (wxEvtHandler*) NULL);
 137
 138 // implementation
 139
 140   int FindMenuIdByMenuItem( GtkWidget *menuItem ) const;
 141   void SetInvokingWindow( wxWindow *win );
 142   wxWindow *GetInvokingWindow();
 143
 144   wxString       m_title;
 145   wxList         m_items;
 146   wxWindow      *m_invokingWindow;
 147   wxFunction     m_callback;
 148   wxEvtHandler  *m_eventHandler;
 149   void          *m_clientData;
 150
 151   GtkWidget     *m_menu;  // GtkMenu
 152   GtkWidget     *m_owner;
 153 };
 154
 155 #endif // __GTKMENUH__