]> icculus.org git repositories - mikachu/openbox.git/blob - src/bindings.hh
put anticipated more-often-used modifier names in front
[mikachu/openbox.git] / src / bindings.hh
1 // -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 2; -*-
2 #ifndef __binding_hh
3 #define __binding_hh
4
5 /*! @file binding.hh
6   @brief I dunno.. some binding stuff?
7 */
8
9 #include <string>
10 #include <vector>
11
12 namespace ob {
13
14 typedef struct Binding {
15   unsigned int modifiers;
16   unsigned int key;
17
18   bool operator==(struct Binding &b2) { return key == b2.key &&
19                                           modifiers == b2.modifiers; }
20   bool operator!=(struct Binding &b2) { return key != b2.key ||
21                                           modifiers != b2.modifiers; }
22   Binding(unsigned int mod, unsigned int k) { modifiers = mod; key = k; }
23 } Binding;
24
25 typedef struct BindingTree {
26   Binding binding;
27   std::string text;
28   int id;     // the id given for the binding in add()
29   bool chain; // true if this is a chain to another key (not an action)
30
31   struct BindingTree *next_sibling; // the next binding in the tree at the same
32                                     // level
33   struct BindingTree *first_child;  // the first child of this binding (next
34                                     // binding in a chained sequence).
35   BindingTree(int id) : binding(0, 0) {
36     this->id = id; chain = true; next_sibling = first_child = 0;
37   }
38   BindingTree() : binding(0, 0) {
39     this->id = -1; chain = true; next_sibling = first_child = 0;
40   }
41 } BindingTree;
42
43 class OBBindings {
44 public:
45   //! A list of strings
46   typedef std::vector<std::string> StringVect;
47
48 private:
49   BindingTree _tree;// root node of the tree (this doesn't have siblings!)
50
51   int find(BindingTree *search);
52   bool translate(const std::string &str, Binding &b);
53   BindingTree *buildtree(const StringVect &keylist, int id);
54   void OBBindings::assimilate(BindingTree *node);
55  
56 public:
57   //! Initializes an OBBinding object
58   OBBindings();
59   //! Destroys the OBBinding object
60   virtual ~OBBindings();
61
62   //! Adds a new binding
63   /*!
64     A binding will fail to be added if the binding already exists (as part of
65     a chain or not), or if any of the strings in the keylist are invalid.    
66     @return true if the binding could be added; false if it could not.
67   */
68   bool add(const StringVect &keylist, int id);
69
70   //! Removes a key binding
71   /*!
72     @return The id of the binding that was removed, or '< 0' if none were
73             removed.
74   */
75   int remove(const StringVect &keylist);
76
77   //! Removes all key bindings
78   void remove_all();
79
80   //! Finds a keybinding and returns its id or '< 0' if it isn't found.
81   /*!
82     @return -1 if the keybinding was not found but does not conflict with
83     any others; -2 if the keybinding conflicts with another.
84   */
85   int find(const StringVect &keylist);
86
87   // XXX: need an exec() function or something that will be used by openbox
88   //      and hold state for which chain we're in etc. (it could have a timer
89   //      for reseting too...)
90
91   void display();
92 };
93
94 }
95
96 #endif // __binding_hh