godotengine
/
godot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
godot/doc/classes/CodeEdit.xml

540 lines
20 KiB
XML
Raw Normal View History

doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<?xml version="1.0" encoding="UTF-8" ?>
<class name="CodeEdit" inherits="TextEdit" version="4.0">
<brief_description>
</brief_description>
<description>
class reference proofreading
2021-03-18 11:04:28 +00:00
[b]Note[/b]: By default [CodeEdit] always use left-to-right text direction to correctly display source code.
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
</description>
<tutorials>
</tutorials>
<methods>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<method name="_confirm_code_completion" qualifiers="virtual">
<return type="void">
</return>
<argument index="0" name="replace" type="bool">
</argument>
<description>
Override this method to define how the selected entry should be inserted. If [code]replace[/code] is true, any existing text should be replaced.
</description>
</method>
<method name="_filter_code_completion_candidates" qualifiers="virtual">
<return type="Array">
</return>
<argument index="0" name="candidates" type="Array">
</argument>
<description>
Override this method to define what items in [code]candidates[/code] should be displayed.
Both [code]candidates[/code] and the return is a [Array] of [Dictionary], see [method get_code_completion_option] for [Dictionary] content.
</description>
</method>
<method name="_request_code_completion" qualifiers="virtual">
<return type="void">
</return>
<argument index="0" name="force" type="bool">
</argument>
<description>
Override this method to define what happens when the user requests code completion. If [code]force[/code] is true, any checks should be bypassed.
</description>
</method>
<method name="add_code_completion_option">
<return type="void">
</return>
<argument index="0" name="type" type="int" enum="CodeEdit.CodeCompletionKind">
</argument>
<argument index="1" name="display_text" type="String">
</argument>
<argument index="2" name="insert_text" type="String">
</argument>
<argument index="3" name="text_color" type="Color" default="Color( 1, 1, 1, 1 )">
</argument>
<argument index="4" name="icon" type="Resource" default="null">
</argument>
<argument index="5" name="value" type="Variant" default="0">
</argument>
<description>
Submits an item to the queue of potential candidates for the autocomplete menu. Call [method update_code_completion_options] to update the list.
[b]Note[/b]: This list will replace all current candidates.
</description>
</method>
<method name="add_comment_delimiter">
<return type="void">
</return>
<argument index="0" name="start_key" type="String">
</argument>
<argument index="1" name="end_key" type="String">
</argument>
<argument index="2" name="line_only" type="bool" default="false">
</argument>
<description>
Adds a comment delimiter.
Both the start and end keys must be symbols. Only the start key has to be unique.
Line only denotes if the region should continue until the end of the line or carry over on to the next line. If the end key is blank this is automatically set to [code]true[/code].
</description>
</method>
<method name="add_string_delimiter">
<return type="void">
</return>
<argument index="0" name="start_key" type="String">
</argument>
<argument index="1" name="end_key" type="String">
</argument>
<argument index="2" name="line_only" type="bool" default="false">
</argument>
<description>
Adds a string delimiter.
Both the start and end keys must be symbols. Only the start key has to be unique.
Line only denotes if the region should continue until the end of the line or carry over on to the next line. If the end key is blank this is automatically set to [code]true[/code].
</description>
</method>
<method name="cancel_code_completion">
<return type="void">
</return>
<description>
Cancels the autocomplete menu.
</description>
</method>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<method name="clear_bookmarked_lines">
<return type="void">
</return>
<description>
</description>
</method>
<method name="clear_breakpointed_lines">
<return type="void">
</return>
<description>
</description>
</method>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<method name="clear_comment_delimiters">
<return type="void">
</return>
<description>
Removes all comment delimiters.
</description>
</method>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<method name="clear_executing_lines">
<return type="void">
</return>
<description>
</description>
</method>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<method name="clear_string_delimiters">
<return type="void">
</return>
<description>
Removes all string delimiters.
</description>
</method>
<method name="confirm_code_completion">
<return type="void">
</return>
<argument index="0" name="replace" type="bool" default="false">
</argument>
<description>
Inserts the selected entry into the text. If [code]replace[/code] is true, any existing text is replaced rather then merged.
</description>
</method>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<method name="get_bookmarked_lines" qualifiers="const">
<return type="Array">
</return>
<description>
</description>
</method>
<method name="get_breakpointed_lines" qualifiers="const">
<return type="Array">
</return>
<description>
</description>
</method>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<method name="get_code_completion_option" qualifiers="const">
<return type="Dictionary">
</return>
<argument index="0" name="index" type="int">
</argument>
<description>
Gets the completion option at [code]index[/code]. The return [Dictionary] has the following key-values:
[code]kind[/code]: [enum CodeCompletionKind]
[code]display_text[/code]: Text that is shown on the autocomplete menu.
[code]insert_text[/code]: Text that is to be inserted when this item is selected.
[code]font_color[/code]: Color of the text on the autocomplete menu.
[code]icon[/code]: Icon to draw on the autocomplete menu.
[code]default_value[/code]: Value of the symbol.
</description>
</method>
<method name="get_code_completion_options" qualifiers="const">
<return type="Dictionary[]">
</return>
<description>
Gets all completion options, see [method get_code_completion_option] for return content.
</description>
</method>
<method name="get_code_completion_selected_index" qualifiers="const">
<return type="int">
</return>
<description>
Gets the index of the current selected completion option.
</description>
</method>
<method name="get_delimiter_end_key" qualifiers="const">
<return type="String">
</return>
<argument index="0" name="delimiter_index" type="int">
</argument>
<description>
Gets the end key for a string or comment region index.
</description>
</method>
<method name="get_delimiter_end_postion" qualifiers="const">
<return type="Vector2">
</return>
<argument index="0" name="line" type="int">
</argument>
<argument index="1" name="column" type="int">
</argument>
<description>
If [code]line[/code] [code]column[/code] is in a string or comment, returns the end position of the region. If not or no end could be found, both [Vector2] values will be [code]-1[/code].
</description>
</method>
<method name="get_delimiter_start_key" qualifiers="const">
<return type="String">
</return>
<argument index="0" name="delimiter_index" type="int">
</argument>
<description>
Gets the start key for a string or comment region index.
</description>
</method>
<method name="get_delimiter_start_postion" qualifiers="const">
<return type="Vector2">
</return>
<argument index="0" name="line" type="int">
</argument>
<argument index="1" name="column" type="int">
</argument>
<description>
If [code]line[/code] [code]column[/code] is in a string or comment, returns the start position of the region. If not or no start could be found, both [Vector2] values will be [code]-1[/code].
</description>
</method>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<method name="get_executing_lines" qualifiers="const">
<return type="Array">
</return>
<description>
</description>
</method>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<method name="get_text_for_code_completion" qualifiers="const">
<return type="String">
</return>
<description>
Returns the full text with char [code]0xFFFF[/code] at the caret location.
</description>
</method>
<method name="has_comment_delimiter" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="start_key" type="String">
</argument>
<description>
Returns [code]true[/code] if comment [code]start_key[/code] exists.
</description>
</method>
<method name="has_string_delimiter" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="start_key" type="String">
</argument>
<description>
Returns [code]true[/code] if string [code]start_key[/code] exists.
</description>
</method>
<method name="is_in_comment" qualifiers="const">
<return type="int">
</return>
<argument index="0" name="line" type="int">
</argument>
<argument index="1" name="column" type="int" default="-1">
</argument>
<description>
Return delimiter index if [code]line[/code] [code]column[/code] is in a comment. If [code]column[/code] is not provided, will return delimiter index if the entire [code]line[/code] is a comment. Otherwise [code]-1[/code].
</description>
</method>
<method name="is_in_string" qualifiers="const">
<return type="int">
</return>
<argument index="0" name="line" type="int">
</argument>
<argument index="1" name="column" type="int" default="-1">
</argument>
<description>
Return the delimiter index if [code]line[/code] [code]column[/code] is in a string. If [code]column[/code] is not provided, will return the delimiter index if the entire [code]line[/code] is a string. Otherwise [code]-1[/code].
</description>
</method>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<method name="is_line_bookmarked" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="line" type="int">
</argument>
<description>
</description>
</method>
<method name="is_line_breakpointed" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="line" type="int">
</argument>
<description>
</description>
</method>
<method name="is_line_executing" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="line" type="int">
</argument>
<description>
</description>
</method>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<method name="remove_comment_delimiter">
<return type="void">
</return>
<argument index="0" name="start_key" type="String">
</argument>
<description>
Removes the comment delimiter with [code]start_key[/code].
</description>
</method>
<method name="remove_string_delimiter">
<return type="void">
</return>
<argument index="0" name="start_key" type="String">
</argument>
<description>
Removes the string delimiter with [code]start_key[/code].
</description>
</method>
<method name="request_code_completion">
<return type="void">
</return>
<argument index="0" name="force" type="bool" default="false">
</argument>
<description>
Emits [signal request_code_completion], if [code]force[/code] is true will bypass all checks. Otherwise will check that the caret is in a word or in front of a prefix. Will ignore the request if all current options are of type file path, node path or signal.
</description>
</method>
<method name="set_code_completion_selected_index">
<return type="void">
</return>
<argument index="0" name="index" type="int">
</argument>
<description>
Sets the current selected completion option.
</description>
</method>
<method name="set_code_hint">
<return type="void">
</return>
<argument index="0" name="code_hint" type="String">
</argument>
<description>
Sets the code hint text. Pass an empty string to clear.
</description>
</method>
<method name="set_code_hint_draw_below">
<return type="void">
</return>
<argument index="0" name="draw_below" type="bool">
</argument>
<description>
Sets if the code hint should draw below the text.
</description>
</method>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<method name="set_line_as_bookmarked">
<return type="void">
</return>
<argument index="0" name="line" type="int">
</argument>
<argument index="1" name="bookmarked" type="bool">
</argument>
<description>
</description>
</method>
<method name="set_line_as_breakpoint">
<return type="void">
</return>
<argument index="0" name="line" type="int">
</argument>
<argument index="1" name="breakpointed" type="bool">
</argument>
<description>
</description>
</method>
<method name="set_line_as_executing">
<return type="void">
</return>
<argument index="0" name="line" type="int">
</argument>
<argument index="1" name="executing" type="bool">
</argument>
<description>
</description>
</method>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<method name="update_code_completion_options">
<return type="void">
</return>
<argument index="0" name="force" type="bool">
</argument>
<description>
Submits all completion options added with [method add_code_completion_option]. Will try to force the autoccomplete menu to popup, if [code]force[/code] is [code]true[/code].
[b]Note[/b]: This will replace all current candidates.
</description>
</method>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
</methods>
<members>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<member name="code_completion_enabled" type="bool" setter="set_code_completion_enabled" getter="is_code_completion_enabled" default="false">
Sets whether code completion is allowed.
</member>
<member name="code_completion_prefixes" type="String[]" setter="set_code_completion_prefixes" getter="get_code_comletion_prefixes" default="[ ]">
Sets prefixes that will trigger code completion.
</member>
<member name="delimiter_comments" type="String[]" setter="set_comment_delimiters" getter="get_comment_delimiters" default="[ ]">
Sets the comment delimiters. All existing comment delimiters will be removed.
</member>
<member name="delimiter_strings" type="String[]" setter="set_string_delimiters" getter="get_string_delimiters" default="[ ]">
Sets the string delimiters. All existing string delimiters will be removed.
</member>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<member name="draw_bookmarks" type="bool" setter="set_draw_bookmarks_gutter" getter="is_drawing_bookmarks_gutter" default="false">
</member>
<member name="draw_breakpoints_gutter" type="bool" setter="set_draw_breakpoints_gutter" getter="is_drawing_breakpoints_gutter" default="false">
</member>
<member name="draw_executing_lines" type="bool" setter="set_draw_executing_lines_gutter" getter="is_drawing_executing_lines_gutter" default="false">
</member>
<member name="draw_fold_gutter" type="bool" setter="set_draw_fold_gutter" getter="is_drawing_fold_gutter" default="false">
</member>
<member name="draw_line_numbers" type="bool" setter="set_draw_line_numbers" getter="is_draw_line_numbers_enabled" default="false">
</member>
[Complex Text Layouts] Add TextServer documentation. Update Font, CanvasItem, Theme and modified controls documentation.
2020-08-12 11:49:10 +00:00
<member name="layout_direction" type="int" setter="set_layout_direction" getter="get_layout_direction" override="true" enum="Control.LayoutDirection" default="2" />
<member name="structured_text_bidi_override_options" type="Array" setter="set_structured_text_bidi_override_options" getter="get_structured_text_bidi_override_options" override="true" default="[ ]" />
<member name="text_direction" type="int" setter="set_text_direction" getter="get_text_direction" override="true" enum="Control.TextDirection" default="1" />
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<member name="zero_pad_line_numbers" type="bool" setter="set_line_numbers_zero_padded" getter="is_line_numbers_zero_padded" default="false">
</member>
</members>
<signals>
<signal name="breakpoint_toggled">
<argument index="0" name="line" type="int">
</argument>
<description>
</description>
</signal>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<signal name="request_code_completion">
<description>
Emitted when the user requests code completion.
</description>
</signal>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
</signals>
<constants>
Update String/Comment, autocomplete and hints docs
2021-05-22 14:11:04 +00:00
<constant name="KIND_CLASS" value="0" enum="CodeCompletionKind">
</constant>
<constant name="KIND_FUNCTION" value="1" enum="CodeCompletionKind">
</constant>
<constant name="KIND_SIGNAL" value="2" enum="CodeCompletionKind">
</constant>
<constant name="KIND_VARIABLE" value="3" enum="CodeCompletionKind">
</constant>
<constant name="KIND_MEMBER" value="4" enum="CodeCompletionKind">
</constant>
<constant name="KIND_ENUM" value="5" enum="CodeCompletionKind">
</constant>
<constant name="KIND_CONSTANT" value="6" enum="CodeCompletionKind">
</constant>
<constant name="KIND_NODE_PATH" value="7" enum="CodeCompletionKind">
</constant>
<constant name="KIND_FILE_PATH" value="8" enum="CodeCompletionKind">
</constant>
<constant name="KIND_PLAIN_TEXT" value="9" enum="CodeCompletionKind">
</constant>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
</constants>
<theme_items>
<theme_item name="background_color" type="Color" default="Color( 0, 0, 0, 0 )">
</theme_item>
<theme_item name="bookmark" type="Texture2D">
</theme_item>
<theme_item name="bookmark_color" type="Color" default="Color( 0.5, 0.64, 1, 0.8 )">
</theme_item>
<theme_item name="brace_mismatch_color" type="Color" default="Color( 1, 0.2, 0.2, 1 )">
</theme_item>
<theme_item name="breakpoint" type="Texture2D">
</theme_item>
<theme_item name="breakpoint_color" type="Color" default="Color( 0.9, 0.29, 0.3, 1 )">
</theme_item>
<theme_item name="can_fold" type="Texture2D">
</theme_item>
<theme_item name="caret_background_color" type="Color" default="Color( 0, 0, 0, 1 )">
</theme_item>
<theme_item name="caret_color" type="Color" default="Color( 0.88, 0.88, 0.88, 1 )">
</theme_item>
<theme_item name="code_folding_color" type="Color" default="Color( 0.8, 0.8, 0.8, 0.8 )">
</theme_item>
<theme_item name="completion" type="StyleBox">
</theme_item>
<theme_item name="completion_background_color" type="Color" default="Color( 0.17, 0.16, 0.2, 1 )">
</theme_item>
<theme_item name="completion_existing_color" type="Color" default="Color( 0.87, 0.87, 0.87, 0.13 )">
</theme_item>
<theme_item name="completion_font_color" type="Color" default="Color( 0.67, 0.67, 0.67, 1 )">
</theme_item>
<theme_item name="completion_lines" type="int" default="7">
</theme_item>
<theme_item name="completion_max_width" type="int" default="50">
</theme_item>
<theme_item name="completion_scroll_color" type="Color" default="Color( 1, 1, 1, 1 )">
</theme_item>
<theme_item name="completion_scroll_width" type="int" default="3">
</theme_item>
<theme_item name="completion_selected_color" type="Color" default="Color( 0.26, 0.26, 0.27, 1 )">
</theme_item>
<theme_item name="current_line_color" type="Color" default="Color( 0.25, 0.25, 0.26, 0.8 )">
</theme_item>
<theme_item name="executing_line" type="Texture2D">
</theme_item>
<theme_item name="executing_line_color" type="Color" default="Color( 0.98, 0.89, 0.27, 1 )">
</theme_item>
<theme_item name="focus" type="StyleBox">
</theme_item>
<theme_item name="folded" type="Texture2D">
</theme_item>
<theme_item name="font" type="Font">
</theme_item>
<theme_item name="font_color" type="Color" default="Color( 0.88, 0.88, 0.88, 1 )">
</theme_item>
[CTL] Add missing font outline drawing routines and theme constants.
2020-12-25 21:45:28 +00:00
<theme_item name="font_outline_color" type="Color" default="Color( 1, 1, 1, 1 )">
The tint of text outline of the [CodeEdit].
</theme_item>
Change themes *_color_* to *_*_color Changed: font_color_accel -> font_accelerator_color font_color_bg -> font_unselected_color font_color_disabled -> font_disabled_color font_color_fg -> font_selected_color font_color_hover -> font_hover_color font_color_hover_pressed -> font_hover_pressed_color font_color_pressed -> font_pressed_color font_color_readonly -> font_readonly_color font_color_selected -> font_selected_color font_color_shadow -> font_shadow_color font_color_uneditable -> font_uneditable_color icon_color_disabled -> icon_disabled_color icon_color_hover -> icon_hover_color icon_color_hover_pressed -> icon_hover_pressed_color icon_color_normal -> icon_normal_color icon_color_pressed -> icon_pressed_color Also includes: font_outline_modulate -> font_outline_color tab_fg -> tab_selected tab_bg -> tab_unselected
2020-12-08 13:11:45 +00:00
<theme_item name="font_readonly_color" type="Color" default="Color( 0.88, 0.88, 0.88, 0.5 )">
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
</theme_item>
Change themes *_color_* to *_*_color Changed: font_color_accel -> font_accelerator_color font_color_bg -> font_unselected_color font_color_disabled -> font_disabled_color font_color_fg -> font_selected_color font_color_hover -> font_hover_color font_color_hover_pressed -> font_hover_pressed_color font_color_pressed -> font_pressed_color font_color_readonly -> font_readonly_color font_color_selected -> font_selected_color font_color_shadow -> font_shadow_color font_color_uneditable -> font_uneditable_color icon_color_disabled -> icon_disabled_color icon_color_hover -> icon_hover_color icon_color_hover_pressed -> icon_hover_pressed_color icon_color_normal -> icon_normal_color icon_color_pressed -> icon_pressed_color Also includes: font_outline_modulate -> font_outline_color tab_fg -> tab_selected tab_bg -> tab_unselected
2020-12-08 13:11:45 +00:00
<theme_item name="font_selected_color" type="Color" default="Color( 0, 0, 0, 1 )">
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
</theme_item>
[Complex Text Layouts] Add TextServer documentation. Update Font, CanvasItem, Theme and modified controls documentation.
2020-08-12 11:49:10 +00:00
<theme_item name="font_size" type="int">
Font size of the [CodeEdit]'s text.
</theme_item>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<theme_item name="line_number_color" type="Color" default="Color( 0.67, 0.67, 0.67, 0.4 )">
</theme_item>
<theme_item name="line_spacing" type="int" default="4">
</theme_item>
<theme_item name="normal" type="StyleBox">
</theme_item>
[CTL] Add missing font outline drawing routines and theme constants.
2020-12-25 21:45:28 +00:00
<theme_item name="outline_size" type="int" default="0">
The size of the text outline.
</theme_item>
doc: Sync classref with current source Bind missing enums.
2020-09-11 10:22:10 +00:00
<theme_item name="read_only" type="StyleBox">
</theme_item>
<theme_item name="safe_line_number_color" type="Color" default="Color( 0.67, 0.78, 0.67, 0.6 )">
</theme_item>
<theme_item name="selection_color" type="Color" default="Color( 0.49, 0.49, 0.49, 1 )">
</theme_item>
<theme_item name="space" type="Texture2D">
</theme_item>
<theme_item name="tab" type="Texture2D">
</theme_item>
<theme_item name="word_highlighted_color" type="Color" default="Color( 0.8, 0.9, 0.9, 0.15 )">
</theme_item>
</theme_items>
</class>