git.sur5r.net Git - i3/i3/blob - include/bindings.h

   1 /*
   2  * vim:ts=4:sw=4:expandtab
   3  *
   4  * i3 - an improved dynamic tiling window manager
   5  * © 2009-2014 Michael Stapelberg and contributors (see also: LICENSE)
   6  *
   7  * bindings.h: Functions for configuring, finding, and running bindings.
   8  *
   9  */
  10 #pragma once
  11
  12 /**
  13  * The name of the default mode.
  14  *
  15  */
  16 const char *DEFAULT_BINDING_MODE;
  17
  18 /**
  19  * Adds a binding from config parameters given as strings and returns a
  20  * pointer to the binding structure. Returns NULL if the input code could not
  21  * be parsed.
  22  *
  23  */
  24 Binding *configure_binding(const char *bindtype, const char *modifiers, const char *input_code,
  25         const char *release, const char *command, const char *mode);
  26
  27 /**
  28  * Grab the bound keys (tell X to send us keypress events for those keycodes)
  29  *
  30  */
  31 void grab_all_keys(xcb_connection_t *conn, bool bind_mode_switch);
  32
  33 /**
  34  * Returns a pointer to the keyboard Binding with the specified modifiers and
  35  * keycode or NULL if no such binding exists.
  36  *
  37  */
  38 Binding *get_keyboard_binding(uint16_t modifiers, bool key_release, xcb_keycode_t keycode);
  39
  40 /**
  41  * Translates keysymbols to keycodes for all bindings which use keysyms.
  42  *
  43  */
  44 void translate_keysyms(void);
  45
  46 /**
  47  * Switches the key bindings to the given mode, if the mode exists
  48  *
  49  */
  50 void switch_mode(const char *new_mode);
  51
  52 /**
  53  * Checks for duplicate key bindings (the same keycode or keysym is configured
  54  * more than once). If a duplicate binding is found, a message is printed to
  55  * stderr and the has_errors variable is set to true, which will start
  56  * i3-nagbar.
  57  *
  58  */
  59 void check_for_duplicate_bindings(struct context *context);