geany/src/keybindings.h

/*
 *      keybindings.h - this file is part of Geany, a fast and lightweight IDE
 *
 *      Copyright 2006-2010 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
 *      Copyright 2006-2010 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
 *
 *      This program is free software; you can redistribute it and/or modify
 *      it under the terms of the GNU General Public License as published by
 *      the Free Software Foundation; either version 2 of the License, or
 *      (at your option) any later version.
 *
 *      This program is distributed in the hope that it will be useful,
 *      but WITHOUT ANY WARRANTY; without even the implied warranty of
 *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *      GNU General Public License for more details.
 *
 *      You should have received a copy of the GNU General Public License
 *      along with this program; if not, write to the Free Software
 *      Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 * $Id$
 */

#ifndef GEANY_KEYBINDINGS_H
#define GEANY_KEYBINDINGS_H 1

/** Function pointer type used for keybinding callbacks. */
typedef void (*GeanyKeyCallback) (guint key_id);

/** Represents a single keybinding action.
 * Use keybindings_set_item() to set. */
typedef struct GeanyKeyBinding
{
	guint key;				/**< Key value in lower-case, such as @c GDK_a or 0 */
	GdkModifierType mods;	/**< Modifier keys, such as @c GDK_CONTROL_MASK or 0 */
	gchar *name;			/**< Key name for the configuration file, such as @c "menu_new" */
	/** Label used in the preferences dialog keybindings tab.
	 * May contain underscores - these won't be displayed. */
	gchar *label;
	/** Function called when the key combination is pressed, or @c NULL to use the group callback
	 * (preferred). @see plugin_set_key_group(). */
	GeanyKeyCallback callback;
	GtkWidget *menu_item;	/**< Optional widget to set an accelerator for, or @c NULL */
}
GeanyKeyBinding;


/** Function pointer type used for keybinding group callbacks.
 * You should return @c TRUE to indicate handling the callback. (Occasionally, if the keybinding
 * cannot apply in the current situation, it is useful to return @c FALSE to allow a later keybinding
 * with the same key combination to handle it). */
typedef gboolean (*GeanyKeyGroupCallback) (guint key_id);

/** A collection of keybindings grouped together. */
typedef struct GeanyKeyGroup GeanyKeyGroup;

/* Plugins should not set these fields. */
#ifdef GEANY_PRIVATE
struct GeanyKeyGroup
{
	const gchar *name;		/* Group name used in the configuration file, such as @c "html_chars" */
	const gchar *label;		/* Group label used in the preferences dialog keybindings tab */
	gsize count;			/* number of keybindings the group holds */
	GeanyKeyBinding *keys;	/* array of GeanyKeyBinding structs */
	gboolean plugin;		/* used by plugin */
	GeanyKeyGroupCallback callback;	/* use this or individual keybinding callbacks */
};
#endif


extern GPtrArray *keybinding_groups;	/* array of GeanyKeyGroup pointers */

extern const gchar keybindings_keyfile_group_name[];


/* Note: we don't need to increment the plugin ABI when appending keybindings or keygroups,
 * just make sure to only insert keybindings/groups immediately before the _COUNT item, so
 * the existing enum values stay the same.
 * The _COUNT item should not be used by plugins, as it may well change. */

/** Keybinding group IDs */
enum GeanyKeyGroupID
{
	GEANY_KEY_GROUP_FILE,			/**< Group for @ref GeanyKeysFileID. */
	GEANY_KEY_GROUP_PROJECT,		/**< Group for @ref GeanyKeysProjectID. */
	GEANY_KEY_GROUP_EDITOR,			/**< Group for @ref GeanyKeysEditorID. */
	GEANY_KEY_GROUP_CLIPBOARD,		/**< Group for @ref GeanyKeysClipboardID. */
	GEANY_KEY_GROUP_SELECT,			/**< Group for @ref GeanyKeysSelectID. */
	GEANY_KEY_GROUP_FORMAT,			/**< Group for @ref GeanyKeysFormatID. */
	GEANY_KEY_GROUP_INSERT,			/**< Group for @ref GeanyKeysInsertID. */
	GEANY_KEY_GROUP_SETTINGS,		/**< Group for @ref GeanyKeysSettingsID. */
	GEANY_KEY_GROUP_SEARCH,			/**< Group for @ref GeanyKeysSearchID. */
	GEANY_KEY_GROUP_GOTO,			/**< Group for @ref GeanyKeysGoToID. */
	GEANY_KEY_GROUP_VIEW,			/**< Group for @ref GeanyKeysViewID. */
	GEANY_KEY_GROUP_FOCUS,			/**< Group for @ref GeanyKeysFocusID. */
	GEANY_KEY_GROUP_NOTEBOOK,		/**< Group for @ref GeanyKeysNotebookTabID. */
	GEANY_KEY_GROUP_DOCUMENT,		/**< Group for @ref GeanyKeysDocumentID. */
	GEANY_KEY_GROUP_BUILD,			/**< Group for @ref GeanyKeysBuildID. */
	GEANY_KEY_GROUP_TOOLS,			/**< Group for @ref GeanyKeysToolsID. */
	GEANY_KEY_GROUP_HELP,			/**< Group for @ref GeanyKeysHelpID. */
	GEANY_KEY_GROUP_COUNT
};

/** File group keybinding command IDs */
enum GeanyKeysFileID
{
	GEANY_KEYS_FILE_NEW,			/**< Keybinding. */
	GEANY_KEYS_FILE_OPEN,			/**< Keybinding. */
	GEANY_KEYS_FILE_OPENSELECTED,	/**< Keybinding. */
	GEANY_KEYS_FILE_SAVE,			/**< Keybinding. */
	GEANY_KEYS_FILE_SAVEAS,			/**< Keybinding. */
	GEANY_KEYS_FILE_SAVEALL,		/**< Keybinding. */
	GEANY_KEYS_FILE_PRINT,			/**< Keybinding. */
	GEANY_KEYS_FILE_CLOSE,			/**< Keybinding. */
	GEANY_KEYS_FILE_CLOSEALL,		/**< Keybinding. */
	GEANY_KEYS_FILE_RELOAD,			/**< Keybinding. */
	GEANY_KEYS_FILE_OPENLASTTAB,	/**< Keybinding. */
	GEANY_KEYS_FILE_COUNT
};

/** Project group keybinding command IDs */
enum GeanyKeysProjectID
{
	GEANY_KEYS_PROJECT_PROPERTIES,		/**< Keybinding. */
	GEANY_KEYS_PROJECT_COUNT
};

/** Editor group keybinding command IDs */
enum GeanyKeysEditorID
{
	GEANY_KEYS_EDITOR_UNDO,						/**< Keybinding. */
	GEANY_KEYS_EDITOR_REDO,						/**< Keybinding. */
	GEANY_KEYS_EDITOR_DELETELINE,				/**< Keybinding. */
	GEANY_KEYS_EDITOR_DUPLICATELINE,			/**< Keybinding. */
	GEANY_KEYS_EDITOR_TRANSPOSELINE,			/**< Keybinding. */
	GEANY_KEYS_EDITOR_SCROLLTOLINE,				/**< Keybinding. */
	GEANY_KEYS_EDITOR_SCROLLLINEUP,				/**< Keybinding. */
	GEANY_KEYS_EDITOR_SCROLLLINEDOWN,			/**< Keybinding. */
	GEANY_KEYS_EDITOR_COMPLETESNIPPET,			/**< Keybinding. */
	GEANY_KEYS_EDITOR_SUPPRESSSNIPPETCOMPLETION, /**< Keybinding. */
	GEANY_KEYS_EDITOR_SNIPPETNEXTCURSOR,		/**< Keybinding. */
	GEANY_KEYS_EDITOR_CONTEXTACTION,			/**< Keybinding. */
	GEANY_KEYS_EDITOR_AUTOCOMPLETE,				/**< Keybinding. */
	GEANY_KEYS_EDITOR_CALLTIP,					/**< Keybinding. */
	GEANY_KEYS_EDITOR_MACROLIST,				/**< Keybinding. */
	GEANY_KEYS_EDITOR_DELETELINETOEND,			/**< Keybinding. */
	GEANY_KEYS_EDITOR_WORDPARTCOMPLETION,		/**< Keybinding. */
	GEANY_KEYS_EDITOR_MOVELINEUP,				/**< Keybinding. */
	GEANY_KEYS_EDITOR_MOVELINEDOWN,				/**< Keybinding. */
	GEANY_KEYS_EDITOR_COUNT
};

/** Clipboard group keybinding command IDs */
enum GeanyKeysClipboardID
{
	GEANY_KEYS_CLIPBOARD_CUT,			/**< Keybinding. */
	GEANY_KEYS_CLIPBOARD_COPY,			/**< Keybinding. */
	GEANY_KEYS_CLIPBOARD_PASTE,			/**< Keybinding. */
	GEANY_KEYS_CLIPBOARD_CUTLINE,		/**< Keybinding. */
	GEANY_KEYS_CLIPBOARD_COPYLINE,		/**< Keybinding. */
	GEANY_KEYS_CLIPBOARD_COUNT
};

/** Select group keybinding command IDs */
enum GeanyKeysSelectID
{

	GEANY_KEYS_SELECT_ALL,				/**< Keybinding. */
	GEANY_KEYS_SELECT_WORD,				/**< Keybinding. */
	GEANY_KEYS_SELECT_LINE,				/**< Keybinding. */
	GEANY_KEYS_SELECT_PARAGRAPH,		/**< Keybinding. */
	GEANY_KEYS_SELECT_WORDPARTLEFT,		/**< Keybinding. */
	GEANY_KEYS_SELECT_WORDPARTRIGHT,	/**< Keybinding. */
	GEANY_KEYS_SELECT_COUNT
};

/** Format group keybinding command IDs */
enum GeanyKeysFormatID
{
	GEANY_KEYS_FORMAT_TOGGLECASE,				/**< Keybinding. */
	GEANY_KEYS_FORMAT_COMMENTLINETOGGLE,		/**< Keybinding. */
	GEANY_KEYS_FORMAT_COMMENTLINE,				/**< Keybinding. */
	GEANY_KEYS_FORMAT_UNCOMMENTLINE,			/**< Keybinding. */
	GEANY_KEYS_FORMAT_INCREASEINDENT,			/**< Keybinding. */
	GEANY_KEYS_FORMAT_DECREASEINDENT,			/**< Keybinding. */
	GEANY_KEYS_FORMAT_INCREASEINDENTBYSPACE,	/**< Keybinding. */
	GEANY_KEYS_FORMAT_DECREASEINDENTBYSPACE,	/**< Keybinding. */
	GEANY_KEYS_FORMAT_AUTOINDENT,				/**< Keybinding. */
	GEANY_KEYS_FORMAT_SENDTOCMD1,				/**< Keybinding. */
	GEANY_KEYS_FORMAT_SENDTOCMD2,				/**< Keybinding. */
	GEANY_KEYS_FORMAT_SENDTOCMD3,				/**< Keybinding. */
	GEANY_KEYS_FORMAT_SENDTOVTE,				/**< Keybinding. */
	GEANY_KEYS_FORMAT_REFLOWPARAGRAPH,			/**< Keybinding. */
	GEANY_KEYS_FORMAT_COUNT
};

/** Insert group keybinding command IDs */
enum GeanyKeysInsertID
{
	GEANY_KEYS_INSERT_DATE,				/**< Keybinding. */
	GEANY_KEYS_INSERT_ALTWHITESPACE,	/**< Keybinding. */
	GEANY_KEYS_INSERT_COUNT
};

/** Settings group keybinding command IDs */
enum GeanyKeysSettingsID
{
	GEANY_KEYS_SETTINGS_PREFERENCES,		/**< Keybinding. */
	GEANY_KEYS_SETTINGS_PLUGINPREFERENCES,	/**< Keybinding. */
	GEANY_KEYS_SETTINGS_COUNT
};

/** Search group keybinding command IDs */
enum GeanyKeysSearchID
{
	GEANY_KEYS_SEARCH_FIND,					/**< Keybinding. */
	GEANY_KEYS_SEARCH_FINDNEXT,				/**< Keybinding. */
	GEANY_KEYS_SEARCH_FINDPREVIOUS,			/**< Keybinding. */
	GEANY_KEYS_SEARCH_FINDINFILES,			/**< Keybinding. */
	GEANY_KEYS_SEARCH_REPLACE,				/**< Keybinding. */
	GEANY_KEYS_SEARCH_FINDNEXTSEL,			/**< Keybinding. */
	GEANY_KEYS_SEARCH_FINDPREVSEL,			/**< Keybinding. */
	GEANY_KEYS_SEARCH_NEXTMESSAGE,			/**< Keybinding. */
	GEANY_KEYS_SEARCH_PREVIOUSMESSAGE,		/**< Keybinding. */
	GEANY_KEYS_SEARCH_FINDUSAGE,			/**< Keybinding. */
	GEANY_KEYS_SEARCH_FINDDOCUMENTUSAGE,	/**< Keybinding. */
	GEANY_KEYS_SEARCH_MARKALL,				/**< Keybinding. */
	GEANY_KEYS_SEARCH_COUNT
};

/** Go To group keybinding command IDs */
enum GeanyKeysGoToID
{
	GEANY_KEYS_GOTO_FORWARD,			/**< Keybinding. */
	GEANY_KEYS_GOTO_BACK,				/**< Keybinding. */
	GEANY_KEYS_GOTO_LINE,				/**< Keybinding. */
	GEANY_KEYS_GOTO_LINESTART,			/**< Keybinding. */
	GEANY_KEYS_GOTO_LINEEND,			/**< Keybinding. */
	GEANY_KEYS_GOTO_MATCHINGBRACE,		/**< Keybinding. */
	GEANY_KEYS_GOTO_TOGGLEMARKER,		/**< Keybinding. */
	GEANY_KEYS_GOTO_NEXTMARKER,			/**< Keybinding. */
	GEANY_KEYS_GOTO_PREVIOUSMARKER,		/**< Keybinding. */
	GEANY_KEYS_GOTO_PREVWORDPART,		/**< Keybinding. */
	GEANY_KEYS_GOTO_NEXTWORDPART,		/**< Keybinding. */
	GEANY_KEYS_GOTO_TAGDEFINITION,		/**< Keybinding. */
	GEANY_KEYS_GOTO_TAGDECLARATION,		/**< Keybinding. */
	GEANY_KEYS_GOTO_LINEENDVISUAL,		/**< Keybinding. */
	GEANY_KEYS_GOTO_COUNT
};

/** View group keybinding command IDs */
enum GeanyKeysViewID
{
	GEANY_KEYS_VIEW_TOGGLEALL,			/**< Keybinding. */
	GEANY_KEYS_VIEW_FULLSCREEN,			/**< Keybinding. */
	GEANY_KEYS_VIEW_MESSAGEWINDOW,		/**< Keybinding. */
	GEANY_KEYS_VIEW_SIDEBAR,			/**< Keybinding. */
	GEANY_KEYS_VIEW_ZOOMIN,				/**< Keybinding. */
	GEANY_KEYS_VIEW_ZOOMOUT,			/**< Keybinding. */
	GEANY_KEYS_VIEW_ZOOMRESET,			/**< Keybinding. */
	GEANY_KEYS_VIEW_COUNT
};

/** Focus group keybinding command IDs */
/* TODO when the plugin ABI get increased the next time, rearrange these keybindings */
enum GeanyKeysFocusID
{
	GEANY_KEYS_FOCUS_EDITOR,				/**< Keybinding. */
	GEANY_KEYS_FOCUS_SCRIBBLE,				/**< Keybinding. */
	GEANY_KEYS_FOCUS_VTE,					/**< Keybinding. */
	GEANY_KEYS_FOCUS_SEARCHBAR,				/**< Keybinding. */
	GEANY_KEYS_FOCUS_SIDEBAR,				/**< Keybinding. */
	GEANY_KEYS_FOCUS_COMPILER,				/**< Keybinding. */
	GEANY_KEYS_FOCUS_MESSAGES,				/**< Keybinding. */
	GEANY_KEYS_FOCUS_MESSAGE_WINDOW,		/**< Keybinding. */
	GEANY_KEYS_FOCUS_SIDEBAR_DOCUMENT_LIST,	/**< Keybinding. */
	GEANY_KEYS_FOCUS_SIDEBAR_SYMBOL_LIST,	/**< Keybinding. */
	GEANY_KEYS_FOCUS_COUNT
};

/** Notebook Tab group keybinding command IDs */
enum GeanyKeysNotebookTabID
{
	GEANY_KEYS_NOTEBOOK_SWITCHTABLEFT,			/**< Keybinding. */
	GEANY_KEYS_NOTEBOOK_SWITCHTABRIGHT,			/**< Keybinding. */
	GEANY_KEYS_NOTEBOOK_SWITCHTABLASTUSED,		/**< Keybinding. */
	GEANY_KEYS_NOTEBOOK_MOVETABLEFT,			/**< Keybinding. */
	GEANY_KEYS_NOTEBOOK_MOVETABRIGHT,			/**< Keybinding. */
	GEANY_KEYS_NOTEBOOK_MOVETABFIRST,			/**< Keybinding. */
	GEANY_KEYS_NOTEBOOK_MOVETABLAST,			/**< Keybinding. */
	GEANY_KEYS_NOTEBOOK_COUNT
};

/** Document group keybinding command IDs */
enum GeanyKeysDocumentID
{
	GEANY_KEYS_DOCUMENT_REPLACETABS,		/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_REPLACESPACES,		/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_TOGGLEFOLD,			/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_FOLDALL,			/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_UNFOLDALL,			/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_RELOADTAGLIST,		/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_LINEWRAP,			/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_LINEBREAK,			/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_REMOVE_MARKERS,		/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_REMOVE_ERROR_INDICATORS,	/**< Keybinding. */
	GEANY_KEYS_DOCUMENT_COUNT
};

/** Build group keybinding command IDs */
enum GeanyKeysBuildID
{
	GEANY_KEYS_BUILD_COMPILE,			/**< Keybinding. */
	GEANY_KEYS_BUILD_LINK,				/**< Keybinding. */
	GEANY_KEYS_BUILD_MAKE,				/**< Keybinding. */
	GEANY_KEYS_BUILD_MAKEOWNTARGET,		/**< Keybinding. */
	GEANY_KEYS_BUILD_MAKEOBJECT,		/**< Keybinding. */
	GEANY_KEYS_BUILD_NEXTERROR,			/**< Keybinding. */
	GEANY_KEYS_BUILD_PREVIOUSERROR,		/**< Keybinding. */
	GEANY_KEYS_BUILD_RUN,				/**< Keybinding. */
	GEANY_KEYS_BUILD_OPTIONS,			/**< Keybinding. */
	GEANY_KEYS_BUILD_COUNT
};

/** Tools group keybinding command IDs */
enum GeanyKeysToolsID
{
	GEANY_KEYS_TOOLS_OPENCOLORCHOOSER,		/**< Keybinding. */
	GEANY_KEYS_TOOLS_COUNT
};

/** Help group keybinding command IDs */
enum GeanyKeysHelpID
{
	GEANY_KEYS_HELP_HELP,			/**< Keybinding. */
	GEANY_KEYS_HELP_COUNT
};


void keybindings_init(void);

void keybindings_load_keyfile(void);

void keybindings_free(void);

GeanyKeyGroup *keybindings_set_group(GeanyKeyGroup *group, const gchar *section_name,
		const gchar *label, gsize count, GeanyKeyGroupCallback callback) G_GNUC_WARN_UNUSED_RESULT;

void keybindings_free_group(GeanyKeyGroup *group);

GeanyKeyBinding *keybindings_set_item(GeanyKeyGroup *group, gsize key_id,
		GeanyKeyCallback callback, guint key, GdkModifierType mod,
		gchar *name, gchar *label, GtkWidget *menu_item);

GeanyKeyBinding *keybindings_get_item(GeanyKeyGroup *group, gsize key_id);

gchar *keybindings_get_label(GeanyKeyBinding *kb);

void keybindings_update_combo(GeanyKeyBinding *kb, guint key, GdkModifierType mods);

void keybindings_send_command(guint group_id, guint key_id);

GeanyKeyBinding *keybindings_lookup_item(guint group_id, guint key_id);

/* just write the content of the keys array to the config file */
void keybindings_write_to_file(void);

void keybindings_show_shortcuts(void);

const GeanyKeyBinding *keybindings_check_event(GdkEventKey *ev, gint *group_id, gint *binding_id);

#endif