2 * editor.h - this file is part of Geany, a fast and lightweight IDE
4 * Copyright 2005 The Geany contributors
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22 #ifndef GEANY_EDITOR_H
23 #define GEANY_EDITOR_H 1
25 #include "tm_tag.h" /* for TMTag */
27 #include "gtkcompat.h" /* Needed by ScintillaWidget.h */
28 #include "Scintilla.h" /* Needed by ScintillaWidget.h */
29 #include "ScintillaWidget.h" /* for ScintillaObject */
36 /* Forward-declared to avoid including document.h since it includes this header */
39 /** Default character set to define which characters should be treated as part of a word. */
40 #define GEANY_WORDCHARS "_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
41 #define GEANY_MAX_WORD_LENGTH 192
43 /** Whether to use tabs, spaces or both to indent. */
46 GEANY_INDENT_TYPE_SPACES
, /**< Spaces. */
47 GEANY_INDENT_TYPE_TABS
, /**< Tabs. */
48 GEANY_INDENT_TYPE_BOTH
/**< Both. */
53 * Auto indentation modes */
56 GEANY_AUTOINDENT_NONE
= 0,
57 GEANY_AUTOINDENT_BASIC
,
58 GEANY_AUTOINDENT_CURRENTCHARS
,
59 GEANY_AUTOINDENT_MATCHBRACES
63 /** Geany indicator types, can be used with Editor indicator functions to highlight
64 * text in the document. */
67 /** Indicator to highlight errors in the document text. This is a red squiggly underline. */
68 GEANY_INDICATOR_ERROR
= 0,
69 /** Indicator used to highlight search results in the document. This is a
70 * rounded box around the text. */
71 /* start container indicator outside of lexer indicators (0..7), see Scintilla docs */
72 GEANY_INDICATOR_SEARCH
= 8,
73 GEANY_INDICATOR_SNIPPET
= 9
77 /** Indentation prefs that might be different according to project or filetype.
78 * Use @c editor_get_indent_prefs() to lookup the prefs for a particular document.
82 typedef struct GeanyIndentPrefs
84 gint width
; /**< Indent width. */
85 GeanyIndentType type
; /**< Whether to use tabs, spaces or both to indent. */
86 /** Width of a tab, but only when using GEANY_INDENT_TYPE_BOTH.
87 * To get the display tab width, use sci_get_tab_width(). */
89 GeanyAutoIndent auto_indent_mode
;
91 gboolean detect_width
;
95 /** Default prefs when creating a new editor window.
96 * Some of these can be overridden per document or per project. */
97 /* @warning Use @c editor_get_prefs() instead to include project overrides. */
98 typedef struct GeanyEditorPrefs
100 GeanyIndentPrefs
*indentation
; /* Default indentation prefs. Use editor_get_indent_prefs(). */
101 gboolean show_white_space
;
102 gboolean show_indent_guide
;
103 gboolean show_line_endings
;
104 /* 0 - line, 1 - background, 2 - disabled. */
106 gint long_line_column
;
107 gchar
*long_line_color
;
108 gboolean show_markers_margin
; /* view menu */
109 gboolean show_linenumber_margin
; /* view menu */
110 gboolean show_scrollbars
; /* hidden pref */
111 gboolean scroll_stop_at_last_line
;
112 gboolean line_wrapping
;
113 gboolean use_indicators
;
115 gboolean unfold_all_children
;
116 gboolean disable_dnd
;
117 gboolean use_tab_to_indent
; /* makes tab key indent instead of insert a tab char */
118 gboolean backspace_unindent
; /* makes backspace char unindent instead of deleting one char */
119 gboolean smart_home_key
;
120 gboolean newline_strip
;
121 gboolean auto_complete_symbols
;
122 gboolean auto_close_xml_tags
;
123 gboolean complete_snippets
;
124 gint symbolcompletion_min_chars
;
125 gint symbolcompletion_max_height
;
126 gboolean brace_match_ltgt
; /* whether to highlight < and > chars (hidden pref) */
127 gboolean use_gtk_word_boundaries
; /* hidden pref */
128 gboolean complete_snippets_whilst_editing
; /* hidden pref */
129 gint line_break_column
;
130 gboolean auto_continue_multiline
;
131 gchar
*comment_toggle_mark
;
132 guint autocompletion_max_entries
;
133 guint autoclose_chars
;
134 gboolean autocomplete_doc_words
;
135 gboolean completion_drops_rest_of_word
;
137 gint show_virtual_space
;
138 gboolean long_line_enabled
;
139 gint autocompletion_update_freq
;
140 gint scroll_lines_around_cursor
;
141 gint ime_interaction
; /* input method editor's candidate window behaviour */
142 gboolean show_line_endings_only_when_differ
;
147 #define GEANY_TYPE_EDITOR (editor_get_type())
148 GType
editor_get_type (void);
150 /** Editor-owned fields for each document. */
151 typedef struct GeanyEditor
153 struct GeanyDocument
*document
; /**< The document associated with the editor. */
154 ScintillaObject
*sci
; /**< The Scintilla editor @c GtkWidget. */
155 gboolean line_wrapping
; /**< @c TRUE if line wrapping is enabled. */
156 gboolean auto_indent
; /**< @c TRUE if auto-indentation is enabled. */
157 /** Percentage to scroll view by on paint, if positive. */
158 gfloat scroll_percent
;
159 GeanyIndentType indent_type
; /* Use editor_get_indent_prefs() instead. */
160 gboolean line_breaking
; /**< Whether to split long lines as you type. */
166 const GeanyIndentPrefs
*editor_get_indent_prefs(GeanyEditor
*editor
);
168 ScintillaObject
*editor_create_widget(GeanyEditor
*editor
);
170 void editor_indicator_set_on_range(GeanyEditor
*editor
, gint indic
, gint start
, gint end
);
172 void editor_indicator_set_on_line(GeanyEditor
*editor
, gint indic
, gint line
);
174 void editor_indicator_clear(GeanyEditor
*editor
, gint indic
);
176 void editor_set_indent_type(GeanyEditor
*editor
, GeanyIndentType type
);
178 void editor_set_indent_width(GeanyEditor
*editor
, gint width
);
180 gchar
*editor_get_word_at_pos(GeanyEditor
*editor
, gint pos
, const gchar
*wordchars
);
182 const gchar
*editor_get_eol_char_name(GeanyEditor
*editor
);
184 gint
editor_get_eol_char_len(GeanyEditor
*editor
);
186 const gchar
*editor_get_eol_char(GeanyEditor
*editor
);
188 void editor_insert_text_block(GeanyEditor
*editor
, const gchar
*text
,
189 gint insert_pos
, gint cursor_index
,
190 gint newline_indent_size
, gboolean replace_newlines
);
192 gint
editor_get_eol_char_mode(GeanyEditor
*editor
);
194 gboolean
editor_goto_pos(GeanyEditor
*editor
, gint pos
, gboolean mark
);
196 const gchar
*editor_find_snippet(GeanyEditor
*editor
, const gchar
*snippet_name
);
198 void editor_insert_snippet(GeanyEditor
*editor
, gint pos
, const gchar
*snippet
);
203 extern GeanyEditorPrefs editor_prefs
;
207 GEANY_VIRTUAL_SPACE_DISABLED
= 0,
208 GEANY_VIRTUAL_SPACE_SELECTION
= 1,
209 GEANY_VIRTUAL_SPACE_ALWAYS
= 3
213 /* Auto-close brackets/quotes */
215 GEANY_AC_PARENTHESIS
= 1,
216 GEANY_AC_CBRACKET
= 2,
217 GEANY_AC_SBRACKET
= 4,
224 gchar
*current_word
; /* holds word under the mouse or keyboard cursor */
225 gint click_pos
; /* text position where the mouse was clicked */
228 extern EditorInfo editor_info
;
231 void editor_init(void);
233 GeanyEditor
*editor_create(struct GeanyDocument
*doc
);
235 void editor_destroy(GeanyEditor
*editor
);
237 void editor_sci_notify_cb(GtkWidget
*widget
, gint scn
, gpointer scnt
, gpointer data
);
239 gboolean
editor_start_auto_complete(GeanyEditor
*editor
, gint pos
, gboolean force
);
241 gboolean
editor_complete_word_part(GeanyEditor
*editor
);
243 gboolean
editor_goto_next_snippet_cursor(GeanyEditor
*editor
);
245 gboolean
editor_complete_snippet(GeanyEditor
*editor
, gint pos
);
247 gboolean
editor_show_calltip(GeanyEditor
*editor
, gint pos
);
249 void editor_do_comment_toggle(GeanyEditor
*editor
);
251 gint
editor_do_comment(GeanyEditor
*editor
, gint line
, gboolean allow_empty_lines
, gboolean toggle
,
252 gboolean single_comment
);
254 gint
editor_do_uncomment(GeanyEditor
*editor
, gint line
, gboolean toggle
);
256 void editor_insert_multiline_comment(GeanyEditor
*editor
);
258 void editor_insert_alternative_whitespace(GeanyEditor
*editor
);
260 void editor_indent(GeanyEditor
*editor
, gboolean increase
);
262 void editor_smart_line_indentation(GeanyEditor
*editor
);
264 void editor_indentation_by_one_space(GeanyEditor
*editor
, gint pos
, gboolean decrease
);
266 gboolean
editor_line_in_view(GeanyEditor
*editor
, gint line
);
268 void editor_scroll_to_line(GeanyEditor
*editor
, gint line
, gfloat percent_of_view
);
270 void editor_display_current_line(GeanyEditor
*editor
, gfloat percent_of_view
);
272 void editor_finalize(void);
274 void editor_snippets_init(void);
276 void editor_snippets_free(void);
278 const GeanyEditorPrefs
*editor_get_prefs(GeanyEditor
*editor
);
281 /* General editing functions */
283 void editor_find_current_word(GeanyEditor
*editor
, gint pos
, gchar
*word
, gsize wordlen
,
286 void editor_find_current_word_sciwc(GeanyEditor
*editor
, gint pos
, gchar
*word
, gsize wordlen
);
288 gchar
*editor_get_default_selection(GeanyEditor
*editor
, gboolean use_current_word
, const gchar
*wordchars
);
291 void editor_select_word(GeanyEditor
*editor
);
293 void editor_select_lines(GeanyEditor
*editor
, gboolean extra_line
);
295 void editor_select_paragraph(GeanyEditor
*editor
);
297 void editor_select_indent_block(GeanyEditor
*editor
);
300 void editor_set_font(GeanyEditor
*editor
, const gchar
*font
);
302 void editor_indicator_clear_errors(GeanyEditor
*editor
);
304 void editor_fold_all(GeanyEditor
*editor
);
306 void editor_unfold_all(GeanyEditor
*editor
);
308 void editor_replace_tabs(GeanyEditor
*editor
, gboolean ignore_selection
);
310 void editor_replace_spaces(GeanyEditor
*editor
, gboolean ignore_selection
);
312 void editor_strip_line_trailing_spaces(GeanyEditor
*editor
, gint line
);
314 void editor_strip_trailing_spaces(GeanyEditor
*editor
, gboolean ignore_selection
);
316 void editor_ensure_final_newline(GeanyEditor
*editor
);
318 void editor_insert_color(GeanyEditor
*editor
, const gchar
*colour
);
320 void editor_set_indent(GeanyEditor
*editor
, GeanyIndentType type
, gint width
);
322 void editor_set_line_wrapping(GeanyEditor
*editor
, gboolean wrap
);
324 gboolean
editor_goto_line(GeanyEditor
*editor
, gint line_no
, gboolean offset
);
326 void editor_set_indentation_guides(GeanyEditor
*editor
);
328 void editor_apply_update_prefs(GeanyEditor
*editor
);
330 void editor_toggle_fold(GeanyEditor
*editor
, gint line
, gint modifiers
);
332 #endif /* GEANY_PRIVATE */
336 #endif /* GEANY_EDITOR_H */