X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fkbmap.h;h=2ffe6885f15c2c452fb40a0f1b7a0364e4fcaa57;hb=52eb91c94fb70d58dceef430659c8781de2eccda;hp=27b62fd1eb9dca98bf9ed8a9bb1e38a76c429ce5;hpb=39eec46bd31753afaec103fcc45f9d6ba75bdb3e;p=lyx.git diff --git a/src/kbmap.h b/src/kbmap.h index 27b62fd1eb..2ffe6885f1 100644 --- a/src/kbmap.h +++ b/src/kbmap.h @@ -1,24 +1,33 @@ // -*- C++ -*- -/* ======================================================================= *\ - File : kbmap.h, kbmap.h,v 1.3 1996/12/10 04:35:57 larsbj Exp - Author : chb, 30.Oct.1995 - Docu : see kbmap.C - Purpose: class definitions for XKeyEvent keymap handling - \* ==================================================================== */ +/** + * \file kbmap.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 + * \author John Levon + * + * Full author contact details are available in file CREDITS. + */ #ifndef KBMAP_H #define KBMAP_H -#ifdef __GNUG__ -#pragma interface -#endif +#include "funcrequest.h" -#include -#include +#include "frontends/key_state.h" +#include "frontends/LyXKeySym.h" -#include "commandtags.h" +#include "support/docstream.h" -#include "LString.h" +#include + +#include +#include + + +namespace lyx { class kb_sequence; @@ -29,70 +38,104 @@ public: * Bind a key sequence to an action. * @return 0 on success, or position in string seq where error * occurs. + * See kb_sequence::parse for the syntax of the seq string + */ + std::string::size_type bind(std::string const & seq, FuncRequest const & func); + + // Parse a bind file + bool read(std::string const & bind_file); + + /** + * print all available keysyms + * @param forgui true if the string should use translations and + * special characters. */ - string::size_type bind(string const & seq, kb_action action); + docstring const print(bool forgui) const; - /// print all available keysyms - string const print() const; - /** * Look up a key press in the keymap. * @param key the keysym * @param mod the modifiers * @param seq the current key sequence so far - * @return the action / LFUN_PREFIX / LFUN_UNKNOWN_ACTION + * @return the action / LFUN_COMMAND_PREFIX / LFUN_UNKNOWN_ACTION */ - kb_action lookup(unsigned int key, - unsigned int mod, kb_sequence * seq) const; + FuncRequest const & + lookup(LyXKeySymPtr key, + key_modifier::state mod, kb_sequence * seq) const; + + /// + typedef std::deque Bindings; /// Given an action, find all keybindings. - string const findbinding(kb_action action, - string const & prefix = string()) const; + Bindings findbindings(FuncRequest const & func) const; + + /// Given an action, print the keybindings. + docstring const printbindings(FuncRequest const & func) const; + + /** + * Given an action, find the first 1-key binding (if it exists). + * The LyXKeySym pointer is 0 is no key is found. + * [only used by the Qt/Mac frontend] + */ + std::pair + find1keybinding(FuncRequest const & func) const; + /** * Returns a string of the given keysym, with modifiers. - * @param key the key + * @param key the key as a keysym * @param mod the modifiers */ - static string const printKeysym(unsigned int key, unsigned int mod); + static std::string const printKeySym(LyXKeySym const & key, + key_modifier::state mod); - /// return the ISO value of a keysym - static char getiso(unsigned int i); + typedef std::pair modifier_pair; private: /// struct kb_key { /// Keysym - unsigned int code; - + LyXKeySymPtr code; + /// Modifier masks - unsigned int mod; - + modifier_pair mod; + /// Keymap for prefix keys boost::shared_ptr table; - + /// Action for !prefix keys - kb_action action; + FuncRequest func; }; - /** * Define an action for a key sequence. * @param r internal recursion level */ - void defkey(kb_sequence * seq, kb_action action, unsigned int r = 0); - - /// Returns a string of the given key - string const printKey(kb_key const & key) const; + void defkey(kb_sequence * seq, FuncRequest const & func, + unsigned int r = 0); + + /** + * Given an action, find all keybindings + * @param func the action + * @param prefix a sequence to prepend the results + */ + Bindings findbindings(FuncRequest const & func, + kb_sequence const & prefix) const; /// is the table empty ? bool empty() const { return table.empty(); } /// - typedef std::list Table; + typedef std::vector Table; /// Table table; }; -#endif +/// Implementation is in lyx_main.C +extern kb_keymap & theTopLevelKeymap(); + + +} // namespace lyx + +#endif // KBMAP_H