X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=src%2Fkbsequence.h;h=3d894a1ec31c54d1fe602cb7db77656a7d757095;hb=37d42d45f3f4a5d3e916a080af50b37ae4a9d118;hp=91c94e045487506f0eb27364ccc99fd83a282bbc;hpb=4820fdd44f4f708ac1364f6a67b7a85a66be7fd0;p=lyx.git diff --git a/src/kbsequence.h b/src/kbsequence.h index 91c94e0454..3d894a1ec3 100644 --- a/src/kbsequence.h +++ b/src/kbsequence.h @@ -1,72 +1,117 @@ // -*- 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 kbsequence.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 KBSEQUENCE_H #define KBSEQUENCE_H -#ifdef __GNUG__ -#pragma interface -#endif +#include "frontends/key_state.h" + +#include +#include #include -#include "LString.h" class kb_keymap; +class LyXKeySym; +class FuncRequest; /// Holds a key sequence and the current and standard keymaps class kb_sequence { public: - /// - kb_sequence() { - stdmap = curmap = 0; - length = 0; - } + typedef boost::shared_ptr LyXKeySymPtr; + typedef std::vector KeySequence; - /** Add a key to the key sequence and look it up in the curmap - if the latter is defined. */ - int addkey(unsigned int key, unsigned int mod, unsigned int nmod = 0); + friend class kb_keymap; /// - int print(string & buf, bool when_defined = false) const; - - /// - int printOptions(string & buf) const; - - /// Make length negative to mark the sequence as deleted - void delseq(); + kb_sequence(kb_keymap * std, kb_keymap * cur) + : stdmap(std), curmap(cur), deleted_(false) {} - /// - char getiso() const; - - /// - unsigned int getsym() const; - - /// + /** + * Add a key to the key sequence and look it up in the curmap + * if the latter is defined. + * @param keysym the key to add + * @param mod modifier mask + * @param nmod which modifiers to mask out for equality test + * @return the action matching this key sequence or LFUN_UNKNOWN_ACTION + */ + FuncRequest const & + addkey(LyXKeySymPtr keysym, key_modifier::state mod, + key_modifier::state nmod = key_modifier::none); + + /** + * Add a sequence of keys from a string to the sequence + * @return string::npos if OK, else error position in string + * + * Keys in the string must be separated with whitespace; + * Use the keysym names used by XStringToKeysym, f.ex. + * "Space", "a", "Return", ... + * Prefixes are S-, C-, M- for shift, control, meta + * Prefixes can also be ignored by using the Tilde "~" + * f.ex.: "~S-Space". + */ + std::string::size_type parse(std::string const & s); + + /** + * Return the current sequence as a string. + * @see parse() + */ + std::string const print() const; + + /** + * Return the current sequence and available options as + * a string. No options are added if no curmap kb map exists. + */ + std::string const printOptions() const; + + /// Mark the sequence as deleted. + void mark_deleted(); + + /// Reset sequence to become "deleted" void reset(); - - /// - int parse(string const & s); - + + /// clear in full + void clear(); + + bool deleted() const { + return deleted_; + } + + /// length of sequence + KeySequence::size_type length() const { + return sequence.size(); + } + /// Keymap to use if a new sequence is starting kb_keymap * stdmap; - + /// Keymap to use for the next key kb_keymap * curmap; - - /** Array holding the current key sequence. - If sequence[length-1] < 0xff it can be used as ISO8859 char */ - std::vector sequence; - - /// - std::vector modifiers; - - /// Current length of key sequence - int length; + +private: + /** + * Array holding the current key sequence as KeySyms. + * If sequence[length - 1] < 0xff it can be used as ISO8859 char + */ + KeySequence sequence; + + typedef std::pair + modifier_pair; + + /// modifiers for keys in the sequence + std::vector modifiers; + + /// is keysequence deleted ? + bool deleted_; }; #endif