-/* This file is part of -*- C++ -*-
-* ======================================================
-*
-* LyX, The Document Processor
-*
-* Copyright 1995 Matthias Ettrich
-* Copyright 1995-2001 The LyX Team.
-*
-* This file is Copyright 1999
-* Jean-Marc Lasgouttes
-*
-*======================================================*/
+// -*- C++ -*-
+/**
+ * \file MenuBackend.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \author Lars Gullik Bjønnes
+ * \author Jean-Marc Lasgouttes
+ *
+ * Full author contact details are available in file CREDITS.
+ */
#ifndef MENUBACKEND_H
#define MENUBACKEND_H
-#ifdef __GNUG__
-#pragma interface
-#endif
+#include "FuncStatus.h"
+#include "FuncRequest.h"
+
+#include <boost/shared_ptr.hpp>
-#include "LString.h"
#include <vector>
+#include <stack>
+
+
+namespace lyx {
-class LyXLex;
+class Lexer;
class Buffer;
+class Menu;
///
class MenuItem {
/** This is the list of opened Documents,
typically for the Documents menu. */
Documents,
+ /** This is the bookmarks */
+ Bookmarks,
///
Toc,
/** This is a list of viewable formats
/** This is a list of importable formats
typically for the File->Export menu. */
ImportFormats,
+ /** This is the list of elements available
+ * for insertion into document. */
+ CharStyles,
+ /** This is the list of user-configurable
+ insets to insert into document */
+ Custom,
+ /** This is the list of XML elements to
+ insert into the document */
+ Elements,
/** This is the list of floats that we can
insert a list for. */
FloatListInsert,
/** This is the list of floats that we can
insert. */
- FloatInsert
+ FloatInsert,
+ /** This is the list of selections that can
+ be pasted. */
+ PasteRecent,
+ /** toolbars */
+ Toolbars,
+ /** Available branches in document */
+ Branches
};
- /// Create a Command type MenuItem
+
+ explicit MenuItem(Kind kind);
+
MenuItem(Kind kind,
- string const & label = string(),
- string const & command = string(),
+ docstring const & label,
+ docstring const & submenu = docstring(),
bool optional = false);
+
MenuItem(Kind kind,
- string const & label,
- int action,
- bool optional = false)
- : kind_(kind), label_(label),
- action_(action), submenu_(), optional_(optional) {}
+ docstring const & label,
+ FuncRequest const & func,
+ bool optional = false);
+ /// This one is just to please boost::shared_ptr<>
+ ~MenuItem();
/// The label of a given menuitem
- string const label() const;
+ docstring const label() const;
/// The keyboard shortcut (usually underlined in the entry)
- string const shortcut() const;
+ docstring const shortcut() const;
/// The complete label, with label and shortcut separated by a '|'
- string const fulllabel() const { return label_;}
+ docstring const fulllabel() const { return label_;}
/// The kind of entry
Kind kind() const { return kind_; }
/// the action (if relevant)
- int action() const { return action_; }
- /// the description of the submenu (if relevant)
- string const & submenu() const { return submenu_; }
+ FuncRequest const & func() const { return func_; }
/// returns true if the entry should be ommited when disabled
bool optional() const { return optional_; }
+ /// returns the status of the lfun associated with this entry
+ FuncStatus const & status() const { return status_; }
+ /// returns the status of the lfun associated with this entry
+ FuncStatus & status() { return status_; }
+ /// returns the status of the lfun associated with this entry
+ void status(FuncStatus const & status) { status_ = status; }
+ /**
+ * returns the binding associated to this action.
+ * Use the native UI format when \c forgui is true.
+ */
+ docstring const binding(bool forgui) const;
+ /// the description of the submenu (if relevant)
+ docstring const & submenuname() const { return submenuname_; }
+ /// set the description of the submenu
+ void submenuname(docstring const & name) { submenuname_ = name; }
+ ///
+ Menu * submenu() const { return submenu_.get(); }
+ ///
+ void submenu(Menu * menu);
+
private:
+ //friend class MenuBackend;
///
Kind kind_;
///
- string label_;
+ docstring label_;
///
- int action_;
+ FuncRequest func_;
///
- string submenu_;
+ docstring submenuname_;
///
bool optional_;
+ ///
+ FuncStatus status_;
+ ///
+ boost::shared_ptr<Menu> submenu_;
};
///
typedef ItemList::const_iterator const_iterator;
///
- explicit Menu(string const & name = string(), bool mb = false)
- : menubar_(mb), name_(name) {}
+ typedef ItemList::size_type size_type;
///
+ explicit Menu(docstring const & name = docstring())
+ : name_(name) {}
+ /// Add the menu item unconditionally
Menu & add(MenuItem const &);
+ /// Checks the associated FuncRequest status before adding the
+ /// menu item.
+ Menu & addWithStatusCheck(MenuItem const &);
///
- Menu & read(LyXLex &);
- /// Expands some special entries of the menu
- /** The entries with the following kind are expanded to a
- sequence of Command MenuItems: Lastfiles, Documents,
- ViewFormats, ExportFormats, UpdateFormats
- */
- void expand(Menu & tomenu, Buffer *) const;
- ///
- bool menubar() const { return menubar_; }
+ Menu & read(Lexer &);
///
- string const & name() const { return name_; }
+ docstring const & name() const { return name_; }
///
bool empty() const { return items_.empty(); }
+ /// Clear the menu content.
+ void clear() { items_.clear(); }
///
ItemList::size_type size() const { return items_.size(); }
///
- bool hasSubmenu(string const &) const;
+ MenuItem const & operator[](size_type) const;
+ ///
+ bool hasFunc(FuncRequest const &) const;
///
const_iterator begin() const {
return items_.begin();
// Check whether the menu shortcuts are unique
void checkShortcuts() const;
+
+ // search for func in this menu iteratively, and put menu
+ // names in a stack.
+ bool searchFunc(FuncRequest & func, std::stack<docstring> & names);
private:
+ friend class MenuBackend;
///
ItemList items_;
///
- bool menubar_;
- ///
- string name_;
+ docstring name_;
};
///
typedef MenuList::const_iterator const_iterator;
///
- void read(LyXLex &);
- /// Set default values for menu structure.
- void defaults();
+ typedef MenuList::iterator iterator;
+ ///
+ MenuBackend() {}
+ ///
+ void read(Lexer &);
///
void add(Menu const &);
///
- bool hasMenu(string const &) const;
+ bool hasMenu(docstring const &) const;
+ ///
+ Menu & getMenu(docstring const &);
///
- Menu & getMenu (string const &);
+ Menu const & getMenu(docstring const &) const;
+ ///
+ Menu const & getMenubar() const;
///
- Menu const & getMenu (string const &) const;
- //
bool empty() const { return menulist_.empty(); }
+ /** This defines a menu whose entries list the FuncRequests
+ that will be removed by expand() in other menus. This is
+ used by the Qt/Mac code
+ */
+ void specialMenu(Menu const &);
+ ///
+ Menu const & specialMenu() { return specialmenu_; }
+
+ /// Expands some special entries of the menu
+ /** The entries with the following kind are expanded to a
+ sequence of Command MenuItems: Lastfiles, Documents,
+ ViewFormats, ExportFormats, UpdateFormats, Branches
+ */
+ void expand(Menu const & frommenu, Menu & tomenu,
+ Buffer const *) const;
///
const_iterator begin() const {
return menulist_.begin();
}
///
+ iterator begin() {
+ return menulist_.begin();
+ }
+ ///
const_iterator end() const {
return menulist_.end();
}
+ ///
+ iterator end() {
+ return menulist_.end();
+ }
private:
///
MenuList menulist_;
+ ///
+ Menu menubar_;
+ ///
+ Menu specialmenu_;
};
///
extern MenuBackend menubackend;
+
+} // namespace lyx
+
#endif /* MENUBACKEND_H */