/*************************************************************************/ /* text_edit.h */ /*************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /*************************************************************************/ /* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */ /* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /*************************************************************************/ #ifndef TEXT_EDIT_H #define TEXT_EDIT_H #include "scene/gui/control.h" #include "scene/gui/popup_menu.h" #include "scene/gui/scroll_bar.h" #include "scene/main/timer.h" #include "scene/resources/syntax_highlighter.h" #include "scene/resources/text_paragraph.h" class TextEdit : public Control { GDCLASS(TextEdit, Control); public: enum GutterType { GUTTER_TYPE_STRING, GUTTER_TPYE_ICON, GUTTER_TPYE_CUSTOM }; enum SelectionMode { SELECTION_MODE_NONE, SELECTION_MODE_SHIFT, SELECTION_MODE_POINTER, SELECTION_MODE_WORD, SELECTION_MODE_LINE }; private: struct GutterInfo { GutterType type = GutterType::GUTTER_TYPE_STRING; String name = ""; int width = 24; bool draw = true; bool clickable = false; bool overwritable = false; ObjectID custom_draw_obj = ObjectID(); StringName custom_draw_callback; }; Vector gutters; int gutters_width = 0; int gutter_padding = 0; void _update_gutter_width(); class Text { public: struct Gutter { Variant metadata; bool clickable = false; Ref icon = Ref(); String text = ""; Color color = Color(1, 1, 1); }; struct Line { Vector gutters; String data; Vector bidi_override; Ref data_buf; bool marked = false; bool hidden = false; Line() { data_buf.instance(); } }; private: mutable Vector text; Ref font; int font_size = -1; Dictionary opentype_features; String language; TextServer::Direction direction = TextServer::DIRECTION_AUTO; bool draw_control_chars = false; int width = -1; int indent_size = 4; int gutter_count = 0; public: void set_indent_size(int p_indent_size); void set_font(const Ref &p_font); void set_font_size(int p_font_size); void set_font_features(const Dictionary &p_features); void set_direction_and_language(TextServer::Direction p_direction, String p_language); void set_draw_control_chars(bool p_draw_control_chars); int get_line_height(int p_line, int p_wrap_index) const; int get_line_width(int p_line) const; int get_max_width(bool p_exclude_hidden = false) const; void set_width(float p_width); int get_line_wrap_amount(int p_line) const; Vector get_line_wrap_ranges(int p_line) const; const Ref get_line_data(int p_line) const; void set(int p_line, const String &p_text, const Vector &p_bidi_override); void set_marked(int p_line, bool p_marked) { text.write[p_line].marked = p_marked; } bool is_marked(int p_line) const { return text[p_line].marked; } void set_hidden(int p_line, bool p_hidden) { text.write[p_line].hidden = p_hidden; } bool is_hidden(int p_line) const { return text[p_line].hidden; } void insert(int p_at, const String &p_text, const Vector &p_bidi_override); void remove(int p_at); int size() const { return text.size(); } void clear(); void invalidate_cache(int p_line, int p_column = -1, const String &p_ime_text = String(), const Vector &p_bidi_override = Vector()); void invalidate_all(); void invalidate_all_lines(); _FORCE_INLINE_ const String &operator[](int p_line) const; /* Gutters. */ void add_gutter(int p_at); void remove_gutter(int p_gutter); void move_gutters(int p_from_line, int p_to_line); void set_line_gutter_metadata(int p_line, int p_gutter, const Variant &p_metadata) { text.write[p_line].gutters.write[p_gutter].metadata = p_metadata; } const Variant &get_line_gutter_metadata(int p_line, int p_gutter) const { return text[p_line].gutters[p_gutter].metadata; } void set_line_gutter_text(int p_line, int p_gutter, const String &p_text) { text.write[p_line].gutters.write[p_gutter].text = p_text; } const String &get_line_gutter_text(int p_line, int p_gutter) const { return text[p_line].gutters[p_gutter].text; } void set_line_gutter_icon(int p_line, int p_gutter, Ref p_icon) { text.write[p_line].gutters.write[p_gutter].icon = p_icon; } const Ref &get_line_gutter_icon(int p_line, int p_gutter) const { return text[p_line].gutters[p_gutter].icon; } void set_line_gutter_item_color(int p_line, int p_gutter, const Color &p_color) { text.write[p_line].gutters.write[p_gutter].color = p_color; } const Color &get_line_gutter_item_color(int p_line, int p_gutter) const { return text[p_line].gutters[p_gutter].color; } void set_line_gutter_clickable(int p_line, int p_gutter, bool p_clickable) { text.write[p_line].gutters.write[p_gutter].clickable = p_clickable; } bool is_line_gutter_clickable(int p_line, int p_gutter) const { return text[p_line].gutters[p_gutter].clickable; } }; struct Cursor { int last_fit_x = 0; int line = 0; int column = 0; ///< cursor int x_ofs = 0; int line_ofs = 0; int wrap_ofs = 0; } cursor; struct Selection { SelectionMode selecting_mode = SelectionMode::SELECTION_MODE_NONE; int selecting_line = 0; int selecting_column = 0; int selected_word_beg = 0; int selected_word_end = 0; int selected_word_origin = 0; bool selecting_text = false; bool active = false; int from_line = 0; int from_column = 0; int to_line = 0; int to_column = 0; bool shiftclick_left = false; } selection; Map syntax_highlighting_cache; struct TextOperation { enum Type { TYPE_NONE, TYPE_INSERT, TYPE_REMOVE }; Type type = TYPE_NONE; int from_line = 0; int from_column = 0; int to_line = 0; int to_column = 0; String text; uint32_t prev_version = 0; uint32_t version = 0; bool chain_forward = false; bool chain_backward = false; }; String ime_text; Point2 ime_selection; TextOperation current_op; List undo_stack; List::Element *undo_stack_pos = nullptr; int undo_stack_max_size; void _clear_redo(); void _do_text_op(const TextOperation &p_op, bool p_reverse); //syntax coloring Ref syntax_highlighter; Set keywords; Dictionary _get_line_syntax_highlighting(int p_line); Set completion_prefixes; bool completion_enabled = false; List completion_sources; Vector completion_options; bool completion_active = false; bool completion_forced = false; ScriptCodeCompletionOption completion_current; String completion_base; int completion_index = 0; Rect2i completion_rect; int completion_line_ofs = 0; String completion_hint; int completion_hint_offset = 0; bool setting_text = false; // data Text text; Dictionary opentype_features; String language; TextDirection text_direction = TEXT_DIRECTION_AUTO; TextDirection input_direction = TEXT_DIRECTION_LTR; Control::StructuredTextParser st_parser = STRUCTURED_TEXT_DEFAULT; Array st_args; bool draw_control_chars = false; uint32_t version = 0; uint32_t saved_version = 0; int max_chars = 0; bool readonly = true; // Initialise to opposite first, so we get past the early-out in set_readonly. bool indent_using_spaces = false; int indent_size = 4; String space_indent = " "; Timer *caret_blink_timer; bool caret_blink_enabled = false; bool draw_caret = true; bool window_has_focus = true; bool block_caret = false; bool right_click_moves_caret = true; bool mid_grapheme_caret_enabled = false; bool wrap_enabled = false; int wrap_at = 0; int wrap_right_offset = 10; bool first_draw = true; bool setting_row = false; bool draw_tabs = false; bool draw_spaces = false; bool override_selected_font_color = false; bool cursor_changed_dirty = false; bool text_changed_dirty = false; bool undo_enabled = true; bool line_length_guidelines = false; int line_length_guideline_soft_col = 80; int line_length_guideline_hard_col = 100; bool hiding_enabled = false; bool draw_minimap = false; int minimap_width = 80; Point2 minimap_char_size = Point2(1, 2); int minimap_line_spacing = 1; bool highlight_all_occurrences = false; bool scroll_past_end_of_file_enabled = false; bool auto_brace_completion_enabled = false; bool brace_matching_enabled = false; bool highlight_current_line = false; bool auto_indent = false; String cut_copy_line; bool insert_mode = false; bool select_identifiers_enabled = false; bool smooth_scroll_enabled = false; bool scrolling = false; bool dragging_selection = false; bool dragging_minimap = false; bool can_drag_minimap = false; bool minimap_clicked = false; double minimap_scroll_ratio = 0.0; double minimap_scroll_click_pos = 0.0; float target_v_scroll = 0.0; float v_scroll_speed = 80.0; String highlighted_word; uint64_t last_dblclk = 0; Timer *idle_detect; Timer *click_select_held; HScrollBar *h_scroll; VScrollBar *v_scroll; bool updating_scrolls = false; Object *tooltip_obj = nullptr; StringName tooltip_func; Variant tooltip_ud; bool next_operation_is_complex = false; bool callhint_below = false; Vector2 callhint_offset; String search_text; uint32_t search_flags = 0; int search_result_line = 0; int search_result_col = 0; bool selecting_enabled = true; bool context_menu_enabled = true; bool shortcut_keys_enabled = true; bool virtual_keyboard_enabled = true; void _generate_context_menu(); int get_visible_rows() const; int get_total_visible_rows() const; int _get_minimap_visible_rows() const; void update_cursor_wrap_offset(); void _update_wrap_at(bool p_force = false); bool line_wraps(int line) const; int times_line_wraps(int line) const; Vector get_wrap_rows_text(int p_line) const; int get_cursor_wrap_index() const; int get_line_wrap_index_at_col(int p_line, int p_column) const; int get_char_count(); double get_scroll_pos_for_line(int p_line, int p_wrap_index = 0) const; void set_line_as_first_visible(int p_line, int p_wrap_index = 0); void set_line_as_center_visible(int p_line, int p_wrap_index = 0); void set_line_as_last_visible(int p_line, int p_wrap_index = 0); int get_first_visible_line() const; int get_last_visible_line() const; int get_last_visible_line_wrap_index() const; double get_visible_rows_offset() const; double get_v_scroll_offset() const; int get_char_pos_for_line(int p_px, int p_line, int p_wrap_index = 0) const; int get_column_x_offset_for_line(int p_char, int p_line) const; void adjust_viewport_to_cursor(); double get_scroll_line_diff() const; void _scroll_moved(double); void _update_scrollbars(); void _v_scroll_input(); void _click_selection_held(); void _update_selection_mode_pointer(); void _update_selection_mode_word(); void _update_selection_mode_line(); void _update_minimap_click(); void _update_minimap_drag(); void _scroll_up(real_t p_delta); void _scroll_down(real_t p_delta); void _pre_shift_selection(); void _post_shift_selection(); void _scroll_lines_up(); void _scroll_lines_down(); //void mouse_motion(const Point& p_pos, const Point& p_rel, int p_button_mask); Size2 get_minimum_size() const override; int _get_control_height() const; Point2 _get_local_mouse_pos() const; void _reset_caret_blink_timer(); void _toggle_draw_caret(); void _update_caches(); void _cursor_changed_emit(); void _text_changed_emit(); void _push_current_op(); /* super internal api, undo/redo builds on it */ void _base_insert_text(int p_line, int p_char, const String &p_text, int &r_end_line, int &r_end_column); String _base_get_text(int p_from_line, int p_from_column, int p_to_line, int p_to_column) const; void _base_remove_text(int p_from_line, int p_from_column, int p_to_line, int p_to_column); int _get_column_pos_of_word(const String &p_key, const String &p_search, uint32_t p_search_flags, int p_from_column); Dictionary _search_bind(const String &p_key, uint32_t p_search_flags, int p_from_line, int p_from_column) const; PopupMenu *menu; PopupMenu *menu_dir; PopupMenu *menu_ctl; void _clear(); void _cancel_completion(); void _cancel_code_hint(); void _confirm_completion(); void _update_completion_candidates(); int _calculate_spaces_till_next_left_indent(int column); int _calculate_spaces_till_next_right_indent(int column); protected: struct Cache { Ref tab_icon; Ref space_icon; Ref folded_eol_icon; Ref style_normal; Ref style_focus; Ref style_readonly; Ref font; int font_size = 16; Color completion_background_color; Color completion_selected_color; Color completion_existing_color; Color completion_font_color; Color caret_color; Color caret_background_color; Color font_color; Color font_selected_color; Color font_readonly_color; Color selection_color; Color mark_color; Color code_folding_color; Color current_line_color; Color line_length_guideline_color; Color brace_mismatch_color; Color word_highlighted_color; Color search_result_color; Color search_result_border_color; Color background_color; int line_spacing = 1; int minimap_width = 0; } cache; virtual String get_tooltip(const Point2 &p_pos) const override; void _insert_text(int p_line, int p_char, const String &p_text, int *r_end_line = nullptr, int *r_end_char = nullptr); void _remove_text(int p_from_line, int p_from_column, int p_to_line, int p_to_column); void _insert_text_at_cursor(const String &p_text); void _gui_input(const Ref &p_gui_input); void _notification(int p_what); void _consume_pair_symbol(char32_t ch); void _consume_backspace_for_pair_symbol(int prev_line, int prev_column); static void _bind_methods(); bool _set(const StringName &p_name, const Variant &p_value); bool _get(const StringName &p_name, Variant &r_ret) const; void _get_property_list(List *p_list) const; public: /* Syntax Highlighting. */ Ref get_syntax_highlighter(); void set_syntax_highlighter(Ref p_syntax_highlighter); /* Gutters. */ void add_gutter(int p_at = -1); void remove_gutter(int p_gutter); int get_gutter_count() const; void set_gutter_name(int p_gutter, const String &p_name); String get_gutter_name(int p_gutter) const; void set_gutter_type(int p_gutter, GutterType p_type); GutterType get_gutter_type(int p_gutter) const; void set_gutter_width(int p_gutter, int p_width); int get_gutter_width(int p_gutter) const; void set_gutter_draw(int p_gutter, bool p_draw); bool is_gutter_drawn(int p_gutter) const; void set_gutter_clickable(int p_gutter, bool p_clickable); bool is_gutter_clickable(int p_gutter) const; void set_gutter_overwritable(int p_gutter, bool p_overwritable); bool is_gutter_overwritable(int p_gutter) const; void set_gutter_custom_draw(int p_gutter, Object *p_object, const StringName &p_callback); // Line gutters. void set_line_gutter_metadata(int p_line, int p_gutter, const Variant &p_metadata); Variant get_line_gutter_metadata(int p_line, int p_gutter) const; void set_line_gutter_text(int p_line, int p_gutter, const String &p_text); String get_line_gutter_text(int p_line, int p_gutter) const; void set_line_gutter_icon(int p_line, int p_gutter, Ref p_icon); Ref get_line_gutter_icon(int p_line, int p_gutter) const; void set_line_gutter_item_color(int p_line, int p_gutter, const Color &p_color); Color get_line_gutter_item_color(int p_line, int p_gutter); void set_line_gutter_clickable(int p_line, int p_gutter, bool p_clickable); bool is_line_gutter_clickable(int p_line, int p_gutter) const; enum MenuItems { MENU_CUT, MENU_COPY, MENU_PASTE, MENU_CLEAR, MENU_SELECT_ALL, MENU_UNDO, MENU_REDO, MENU_DIR_INHERITED, MENU_DIR_AUTO, MENU_DIR_LTR, MENU_DIR_RTL, MENU_DISPLAY_UCC, MENU_INSERT_LRM, MENU_INSERT_RLM, MENU_INSERT_LRE, MENU_INSERT_RLE, MENU_INSERT_LRO, MENU_INSERT_RLO, MENU_INSERT_PDF, MENU_INSERT_ALM, MENU_INSERT_LRI, MENU_INSERT_RLI, MENU_INSERT_FSI, MENU_INSERT_PDI, MENU_INSERT_ZWJ, MENU_INSERT_ZWNJ, MENU_INSERT_WJ, MENU_INSERT_SHY, MENU_MAX }; enum SearchFlags { SEARCH_MATCH_CASE = 1, SEARCH_WHOLE_WORDS = 2, SEARCH_BACKWARDS = 4 }; virtual CursorShape get_cursor_shape(const Point2 &p_pos = Point2i()) const override; void _get_mouse_pos(const Point2i &p_mouse, int &r_row, int &r_col) const; void _get_minimap_mouse_row(const Point2i &p_mouse, int &r_row) const; //void delete_char(); //void delete_line(); void begin_complex_operation(); void end_complex_operation(); bool is_insert_text_operation(); void set_text_direction(TextDirection p_text_direction); TextDirection get_text_direction() const; void set_opentype_feature(const String &p_name, int p_value); int get_opentype_feature(const String &p_name) const; void clear_opentype_features(); void set_language(const String &p_language); String get_language() const; void set_draw_control_chars(bool p_draw_control_chars); bool get_draw_control_chars() const; void set_structured_text_bidi_override(Control::StructuredTextParser p_parser); Control::StructuredTextParser get_structured_text_bidi_override() const; void set_structured_text_bidi_override_options(Array p_args); Array get_structured_text_bidi_override_options() const; void set_highlighted_word(const String &new_word); void set_text(String p_text); void insert_text_at_cursor(const String &p_text); void insert_at(const String &p_text, int at); int get_line_count() const; void set_line_as_marked(int p_line, bool p_marked); void set_line_as_hidden(int p_line, bool p_hidden); bool is_line_hidden(int p_line) const; void fold_all_lines(); void unhide_all_lines(); int num_lines_from(int p_line_from, int visible_amount) const; int num_lines_from_rows(int p_line_from, int p_wrap_index_from, int visible_amount, int &wrap_index) const; int get_last_unhidden_line() const; bool can_fold(int p_line) const; bool is_folded(int p_line) const; Vector get_folded_lines() const; void fold_line(int p_line); void unfold_line(int p_line); void toggle_fold_line(int p_line); String get_text(); String get_line(int line) const; void set_line(int line, String new_text); int get_row_height() const; void backspace_at_cursor(); void indent_left(); void indent_right(); int get_indent_level(int p_line) const; bool is_line_comment(int p_line) const; inline void set_scroll_pass_end_of_file(bool p_enabled) { scroll_past_end_of_file_enabled = p_enabled; update(); } inline void set_auto_brace_completion(bool p_enabled) { auto_brace_completion_enabled = p_enabled; } inline void set_brace_matching(bool p_enabled) { brace_matching_enabled = p_enabled; update(); } inline void set_callhint_settings(bool below, Vector2 offset) { callhint_below = below; callhint_offset = offset; } void set_auto_indent(bool p_auto_indent); void center_viewport_to_cursor(); void set_mid_grapheme_caret_enabled(const bool p_enabled); bool get_mid_grapheme_caret_enabled() const; void cursor_set_column(int p_col, bool p_adjust_viewport = true); void cursor_set_line(int p_row, bool p_adjust_viewport = true, bool p_can_be_hidden = true, int p_wrap_index = 0); int cursor_get_column() const; int cursor_get_line() const; Vector2i _get_cursor_pixel_pos(bool p_adjust_viewport = true); bool cursor_get_blink_enabled() const; void cursor_set_blink_enabled(const bool p_enabled); float cursor_get_blink_speed() const; void cursor_set_blink_speed(const float p_speed); void cursor_set_block_mode(const bool p_enable); bool cursor_is_block_mode() const; void set_right_click_moves_caret(bool p_enable); bool is_right_click_moving_caret() const; SelectionMode get_selection_mode() const; void set_selection_mode(SelectionMode p_mode, int p_line = -1, int p_column = -1); int get_selection_line() const; int get_selection_column() const; void set_readonly(bool p_readonly); bool is_readonly() const; void set_max_chars(int p_max_chars); int get_max_chars() const; void set_wrap_enabled(bool p_wrap_enabled); bool is_wrap_enabled() const; void clear(); void cut(); void copy(); void paste(); void select_all(); void select(int p_from_line, int p_from_column, int p_to_line, int p_to_column); void deselect(); void swap_lines(int line1, int line2); void set_search_text(const String &p_search_text); void set_search_flags(uint32_t p_flags); void set_current_search_result(int line, int col); void set_highlight_all_occurrences(const bool p_enabled); bool is_highlight_all_occurrences_enabled() const; bool is_selection_active() const; int get_selection_from_line() const; int get_selection_from_column() const; int get_selection_to_line() const; int get_selection_to_column() const; String get_selection_text() const; String get_word_under_cursor() const; String get_word_at_pos(const Vector2 &p_pos) const; bool search(const String &p_key, uint32_t p_search_flags, int p_from_line, int p_from_column, int &r_line, int &r_column) const; void undo(); void redo(); void clear_undo_history(); void set_indent_using_spaces(const bool p_use_spaces); bool is_indent_using_spaces() const; void set_indent_size(const int p_size); int get_indent_size(); void set_draw_tabs(bool p_draw); bool is_drawing_tabs() const; void set_draw_spaces(bool p_draw); bool is_drawing_spaces() const; void set_override_selected_font_color(bool p_override_selected_font_color); bool is_overriding_selected_font_color() const; void set_insert_mode(bool p_enabled); bool is_insert_mode() const; void add_keyword(const String &p_keyword); void clear_keywords(); double get_v_scroll() const; void set_v_scroll(double p_scroll); int get_h_scroll() const; void set_h_scroll(int p_scroll); void set_smooth_scroll_enabled(bool p_enable); bool is_smooth_scroll_enabled() const; void set_v_scroll_speed(float p_speed); float get_v_scroll_speed() const; uint32_t get_version() const; uint32_t get_saved_version() const; void tag_saved_version(); void menu_option(int p_option); void set_highlight_current_line(bool p_enabled); bool is_highlight_current_line_enabled() const; void set_show_line_length_guidelines(bool p_show); void set_line_length_guideline_soft_column(int p_column); void set_line_length_guideline_hard_column(int p_column); void set_draw_minimap(bool p_draw); bool is_drawing_minimap() const; void set_minimap_width(int p_minimap_width); int get_minimap_width() const; void set_hiding_enabled(bool p_enabled); bool is_hiding_enabled() const; void set_tooltip_request_func(Object *p_obj, const StringName &p_function, const Variant &p_udata); void set_completion(bool p_enabled, const Vector &p_prefixes); void code_complete(const List &p_strings, bool p_forced = false); void set_code_hint(const String &p_hint); void query_code_comple(); void set_select_identifiers_on_hover(bool p_enable); bool is_selecting_identifiers_on_hover_enabled() const; void set_context_menu_enabled(bool p_enable); bool is_context_menu_enabled(); void set_selecting_enabled(bool p_enabled); bool is_selecting_enabled() const; void set_shortcut_keys_enabled(bool p_enabled); bool is_shortcut_keys_enabled() const; void set_virtual_keyboard_enabled(bool p_enable); bool is_virtual_keyboard_enabled() const; PopupMenu *get_menu() const; String get_text_for_completion(); String get_text_for_lookup_completion(); virtual bool is_text_field() const override; TextEdit(); ~TextEdit(); }; VARIANT_ENUM_CAST(TextEdit::GutterType); VARIANT_ENUM_CAST(TextEdit::SelectionMode); VARIANT_ENUM_CAST(TextEdit::MenuItems); VARIANT_ENUM_CAST(TextEdit::SearchFlags); #endif // TEXT_EDIT_H