include/wx/menuitem.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/menuitem.h
   3 // Purpose:     wxMenuItem class
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     25.10.99
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1999 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_MENUITEM_H_BASE_
  13 #define _WX_MENUITEM_H_BASE_
  14
  15 #include "wx/defs.h"
  16
  17 #if wxUSE_MENUS
  18
  19 // ----------------------------------------------------------------------------
  20 // headers
  21 // ----------------------------------------------------------------------------
  22
  23 #include "wx/object.h"  // base class
  24
  25 // ----------------------------------------------------------------------------
  26 // forward declarations
  27 // ----------------------------------------------------------------------------
  28
  29 class WXDLLIMPEXP_FWD_CORE wxAcceleratorEntry;
  30 class WXDLLIMPEXP_FWD_CORE wxMenuItem;
  31 class WXDLLIMPEXP_FWD_CORE wxMenu;
  32
  33 // ----------------------------------------------------------------------------
  34 // wxMenuItem is an item in the menu which may be either a normal item, a sub
  35 // menu or a separator
  36 // ----------------------------------------------------------------------------
  37
  38 class WXDLLIMPEXP_CORE wxMenuItemBase : public wxObject
  39 {
  40 public:
  41     // creation
  42     static wxMenuItem *New(wxMenu *parentMenu = NULL,
  43                            int itemid = wxID_SEPARATOR,
  44                            const wxString& text = wxEmptyString,
  45                            const wxString& help = wxEmptyString,
  46                            wxItemKind kind = wxITEM_NORMAL,
  47                            wxMenu *subMenu = NULL);
  48
  49     // destruction: wxMenuItem will delete its submenu
  50     virtual ~wxMenuItemBase();
  51
  52     // the menu we're in
  53     wxMenu *GetMenu() const { return m_parentMenu; }
  54     void SetMenu(wxMenu* menu) { m_parentMenu = menu; }
  55
  56     // get/set id
  57     void SetId(int itemid) { m_id = itemid; }
  58     int  GetId() const { return m_id; }
  59
  60     // the item's text (or name)
  61     //
  62     // NB: the item's label includes the accelerators and mnemonics info (if
  63     //     any), i.e. it may contain '&' or '_' or "\t..." and thus is
  64     //     different from the item's text which only contains the text shown
  65     //     in the menu. This used to be called SetText.
  66     virtual void SetItemLabel(const wxString& str);
  67
  68     // return the item label including any mnemonics and accelerators.
  69     // This used to be called GetText.
  70     virtual wxString GetItemLabel() const { return m_text; }
  71
  72     // return just the text of the item label, without any mnemonics
  73     // This used to be called GetLabel.
  74     virtual wxString GetItemLabelText() const { return GetLabelText(m_text); }
  75
  76     // return just the text part of the given label (implemented in platform-specific code)
  77     // This used to be called GetLabelFromText.
  78     static wxString GetLabelText(const wxString& label);
  79
  80     // what kind of menu item we are
  81     wxItemKind GetKind() const { return m_kind; }
  82     void SetKind(wxItemKind kind) { m_kind = kind; }
  83     bool IsSeparator() const { return m_kind == wxITEM_SEPARATOR; }
  84
  85     bool IsCheck() const { return m_kind == wxITEM_CHECK; }
  86     bool IsRadio() const { return m_kind == wxITEM_RADIO; }
  87
  88     virtual void SetCheckable(bool checkable)
  89         { m_kind = checkable ? wxITEM_CHECK : wxITEM_NORMAL; }
  90
  91     // Notice that this doesn't quite match SetCheckable().
  92     bool IsCheckable() const
  93         { return m_kind == wxITEM_CHECK || m_kind == wxITEM_RADIO; }
  94
  95     bool IsSubMenu() const { return m_subMenu != NULL; }
  96     void SetSubMenu(wxMenu *menu) { m_subMenu = menu; }
  97     wxMenu *GetSubMenu() const { return m_subMenu; }
  98
  99     // state
 100     virtual void Enable(bool enable = true) { m_isEnabled = enable; }
 101     virtual bool IsEnabled() const { return m_isEnabled; }
 102
 103     virtual void Check(bool check = true) { m_isChecked = check; }
 104     virtual bool IsChecked() const { return m_isChecked; }
 105     void Toggle() { Check(!m_isChecked); }
 106
 107     // help string (displayed in the status bar by default)
 108     void SetHelp(const wxString& str);
 109     const wxString& GetHelp() const { return m_help; }
 110
 111 #if wxUSE_ACCEL
 112     // extract the accelerator from the given menu string, return NULL if none
 113     // found
 114     static wxAcceleratorEntry *GetAccelFromString(const wxString& label);
 115
 116     // get our accelerator or NULL (caller must delete the pointer)
 117     virtual wxAcceleratorEntry *GetAccel() const;
 118
 119     // set the accel for this item - this may also be done indirectly with
 120     // SetText()
 121     virtual void SetAccel(wxAcceleratorEntry *accel);
 122 #endif // wxUSE_ACCEL
 123
 124 #if WXWIN_COMPATIBILITY_2_8
 125     // compatibility only, use new functions in the new code
 126     wxDEPRECATED( void SetName(const wxString& str) );
 127     wxDEPRECATED( wxString GetName() const );
 128
 129     // Now use GetItemLabelText
 130     wxDEPRECATED( wxString GetLabel() const ) ;
 131
 132     // Now use GetItemLabel
 133     wxDEPRECATED( const wxString& GetText() const );
 134
 135     // Now use GetLabelText to strip the accelerators
 136     static wxDEPRECATED( wxString GetLabelFromText(const wxString& text) );
 137
 138     // Now use SetItemLabel
 139     wxDEPRECATED( virtual void SetText(const wxString& str) );
 140 #endif // WXWIN_COMPATIBILITY_2_8
 141
 142     static wxMenuItem *New(wxMenu *parentMenu,
 143                            int itemid,
 144                            const wxString& text,
 145                            const wxString& help,
 146                            bool isCheckable,
 147                            wxMenu *subMenu = NULL)
 148     {
 149         return New(parentMenu, itemid, text, help,
 150                    isCheckable ? wxITEM_CHECK : wxITEM_NORMAL, subMenu);
 151     }
 152
 153 protected:
 154     wxWindowIDRef m_id;             // numeric id of the item >= 0 or wxID_ANY or wxID_SEPARATOR
 155     wxMenu       *m_parentMenu,     // the menu we belong to
 156                  *m_subMenu;        // our sub menu or NULL
 157     wxString      m_text,           // label of the item
 158                   m_help;           // the help string for the item
 159     wxItemKind    m_kind;           // separator/normal/check/radio item?
 160     bool          m_isChecked;      // is checked?
 161     bool          m_isEnabled;      // is enabled?
 162
 163     // this ctor is for the derived classes only, we're never created directly
 164     wxMenuItemBase(wxMenu *parentMenu = NULL,
 165                    int itemid = wxID_SEPARATOR,
 166                    const wxString& text = wxEmptyString,
 167                    const wxString& help = wxEmptyString,
 168                    wxItemKind kind = wxITEM_NORMAL,
 169                    wxMenu *subMenu = NULL);
 170
 171 private:
 172     // and, if we have one ctor, compiler won't generate a default copy one, so
 173     // declare them ourselves - but don't implement as they shouldn't be used
 174     wxMenuItemBase(const wxMenuItemBase& item);
 175     wxMenuItemBase& operator=(const wxMenuItemBase& item);
 176 };
 177
 178 #if WXWIN_COMPATIBILITY_2_8
 179 inline void wxMenuItemBase::SetName(const wxString &str)
 180     { SetItemLabel(str); }
 181 inline wxString wxMenuItemBase::GetName() const
 182     { return GetItemLabel(); }
 183 inline wxString wxMenuItemBase::GetLabel() const
 184     { return GetLabelText(m_text); }
 185 inline const wxString& wxMenuItemBase::GetText() const { return m_text; }
 186 inline void wxMenuItemBase::SetText(const wxString& text) { SetItemLabel(text); }
 187 #endif // WXWIN_COMPATIBILITY_2_8
 188
 189 // ----------------------------------------------------------------------------
 190 // include the real class declaration
 191 // ----------------------------------------------------------------------------
 192
 193 #ifdef wxUSE_BASE_CLASSES_ONLY
 194     #define wxMenuItem wxMenuItemBase
 195 #else // !wxUSE_BASE_CLASSES_ONLY
 196 #if defined(__WXUNIVERSAL__)
 197     #include "wx/univ/menuitem.h"
 198 #elif defined(__WXMSW__)
 199     #include "wx/msw/menuitem.h"
 200 #elif defined(__WXMOTIF__)
 201     #include "wx/motif/menuitem.h"
 202 #elif defined(__WXGTK20__)
 203     #include "wx/gtk/menuitem.h"
 204 #elif defined(__WXGTK__)
 205     #include "wx/gtk1/menuitem.h"
 206 #elif defined(__WXMAC__)
 207     #include "wx/osx/menuitem.h"
 208 #elif defined(__WXCOCOA__)
 209     #include "wx/cocoa/menuitem.h"
 210 #elif defined(__WXPM__)
 211     #include "wx/os2/menuitem.h"
 212 #endif
 213 #endif // wxUSE_BASE_CLASSES_ONLY/!wxUSE_BASE_CLASSES_ONLY
 214
 215 #endif // wxUSE_MENUS
 216
 217 #endif
 218     // _WX_MENUITEM_H_BASE_