// -*- C++ -*-
+/**
+ * \file LyXAction.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 John Levon
+ *
+ * Full author contact details are available in file CREDITS.
+ */
+
#ifndef LYXACTION_H
#define LYXACTION_H
-#ifdef __GNUG__
-#pragma interface
-#endif
-
-#include <map>
+#include "lfuns.h"
-#include "commandtags.h"
#include "LString.h"
#include <boost/utility.hpp>
+#include <map>
+
-/** This class encapsulates LyX action and user command operations.
+class FuncRequest;
+
+/**
+ * This class is a container for LyX actions. It also
+ * stores and managers "pseudo-actions". Pseudo-actions
+ * are not part of the kb_action enum, but are created
+ * dynamically, for encapsulating a real action and an
+ * argument. They are used for things like the menus.
*/
class LyXAction : boost::noncopyable {
private:
- ///
+ /// information for an action
struct func_info {
- ///
+ /// the action name
string name;
- ///
+ /// the func_attrib values set
unsigned int attrib;
- ///
- string helpText;
};
- ///
- struct pseudo_func {
- ///
- kb_action action;
- ///
- string arg;
- };
public:
- ///
+ /// type for map between a function name and its action
typedef std::map<string, kb_action> func_map;
- ///
+ /// type for map between an action and its info
typedef std::map<kb_action, func_info> info_map;
- ///
- typedef std::map<unsigned int, pseudo_func> pseudo_map;
- ///
+ /// type for a map between a pseudo-action and its stored action/arg
+ typedef std::map<unsigned int, FuncRequest> pseudo_map;
+ /// map from argument to pseudo-action
typedef std::map<string, unsigned int> arg_item;
- ///
+ /// map from an action to all its dependent pseudo-actions
typedef std::map<kb_action, arg_item> arg_map;
- ///
+ /// possible "permissions" for an action
enum func_attrib {
- /// nothing special about this func
- Noop = 0,
- /// can be used in RO mode (perhaps this should change)
- ReadOnly = 1, // ,
- /// Can be used when there is no document open
- NoBuffer = 2,
- //Interactive = 2, // Is interactive (requires a GUI)
- ///
- Argument = 4 // Requires argument
- //MathOnly = 8, // Only math mode
- //EtcEtc = ... // Or other attributes...
+ Noop = 0, //< nothing special about this func
+ ReadOnly = 1, //< can be used in RO mode (perhaps this should change)
+ NoBuffer = 2, //< Can be used when there is no document open
+ Argument = 4 //< Requires argument
};
-
- ///
- LyXAction();
-
- /** Returns an action tag from a string. Returns kb_action.
- Include arguments in func_name ONLY if you
- want to create new pseudo actions. */
- int LookupFunc(string const & func_name) const;
- /** Returns an action tag which name is the most similar to a string.
- Don't include arguments, they would be ignored. */
- int getApproxFunc(string const & func) const;
+ LyXAction();
- /** Returns an action name the most similar to a string.
- Don't include arguments, they would be ignored. */
- string const getApproxFuncName(string const & func) const;
+ /**
+ * Returns an pseudoaction from a string
+ * If you include arguments in func_name, a new pseudoaction
+ * will be created if needed.
+ */
+ int LookupFunc(string const & func_name);
/// Returns a pseudo-action given an action and its argument.
- int getPseudoAction(kb_action action, string const & arg) const;
+ int getPseudoAction(kb_action action, string const & arg);
+
+ /**
+ * Given a pseudo-action, return the real action and
+ * associated argument
+ */
+ FuncRequest retrieveActionArg(int pseudo) const;
- /// Retrieves the real action and its argument.
- kb_action retrieveActionArg(int i, string & arg) const;
-
/// Search for an existent pseudoaction, return -1 if it doesn't exist.
int searchActionArg(kb_action action, string const & arg) const;
- /// Check if a value is a pseudo-action.
- bool isPseudoAction(int) const;
-
- /// Return the name associated with command
+ /// Return the name (and argument) associated with the given (pseudo) action
string const getActionName(int action) const;
- /// Return one line help text associated with (pseudo)action
- string const helpText(int action) const;
-
/// True if the command has `flag' set
bool funcHasFlag(kb_action action, func_attrib flag) const;
+ /// iterator across all real actions
typedef func_map::const_iterator const_func_iterator;
+
+ /// return an iterator to the start of all real actions
const_func_iterator func_begin() const;
+
+ /// return an iterator to the end of all real actions
const_func_iterator func_end() const;
+
private:
- ///
+ /// populate the action container with our actions
void init();
- ///
- void newFunc(kb_action, string const & name,
- string const & helpText, unsigned int attrib);
-
- /** This is a list of all the LyXFunc names with the
- coresponding action number. It is usually only used by the
- minibuffer or when assigning commands to keys during init. */
+ /// add the given action
+ void newFunc(kb_action, string const & name, unsigned int attrib);
+
+ /**
+ * This is a list of all the LyXFunc names with the
+ * coresponding action number. It is usually only used by the
+ * minibuffer or when assigning commands to keys during init.
+ */
func_map lyx_func_map;
-
- /** This is a mapping from action number to an object holding
- info about this action. f.ex. helptext, command name (string),
- command attributes (ro) */
+
+ /**
+ * This is a mapping from action number to an object holding
+ * info about this action. f.ex. command name (string),
+ * command attributes (ro)
+ */
info_map lyx_info_map;
-
- /** A mapping from the automatically created pseudo action number
- to the real action and its argument. */
- mutable pseudo_map lyx_pseudo_map;
-
- /** A (multi) mapping from the lyx action to all the generated
- pseudofuncs and the arguments the action should use. */
- mutable arg_map lyx_arg_map;
+
+ /**
+ * A mapping from the automatically created pseudo action number
+ * to the real action and its argument.
+ */
+ pseudo_map lyx_pseudo_map;
+
+ /**
+ * A (multi) mapping from the lyx action to all the generated
+ * pseudofuncs and the arguments the action should use.
+ */
+ arg_map lyx_arg_map;
};
-
-
-/* -------------------- Inlines ------------------ */
-
-
-inline
-bool LyXAction::isPseudoAction(int a) const
-{
- return a > int(LFUN_LASTACTION);
-}
-
-#endif
+
+/// singleton instance
+extern LyXAction lyxaction;
+
+#endif // LYXACTION_H