diff --git a/doc/classes/CodeEdit.xml b/doc/classes/CodeEdit.xml index 136b8e5fc5d..a65d587e8b4 100644 --- a/doc/classes/CodeEdit.xml +++ b/doc/classes/CodeEdit.xml @@ -80,7 +80,7 @@ - Returns if the given line is foldable, that is, it has indented lines right below it or a comment / string block. + Returns [code]true[/code] if the given line is foldable. A line is foldable if it is the start of a valid code region (see [method get_code_region_start_tag]), if it is the start of a comment or string block, or if the next non-empty line is more indented (see [method TextEdit.get_indent_level]). @@ -153,7 +153,7 @@ - Perform an indent as if the user activated the "ui_text_indent" action. + If there is no selection, indentation is inserted at the caret. Otherwise, the selected lines are indented like [method indent_lines]. Equivalent to the [member ProjectSettings.input/ui_text_indent] action. The indentation characters used depend on [member indent_use_spaces] and [member indent_size]. @@ -276,7 +276,7 @@ - Returns all lines that are current folded. + Returns all lines that are currently folded. @@ -330,7 +330,7 @@ - Indents selected lines, or in the case of no selection the caret line by one. + Indents all lines that are selected or have a caret on them. Uses spaces or a tab depending on [member indent_use_spaces]. See [method unindent_lines]. @@ -353,42 +353,42 @@ - Returns whether the line at the specified index is bookmarked or not. + Returns [code]true[/code] if the given line is bookmarked. See [method set_line_as_bookmarked]. - Returns whether the line at the specified index is breakpointed or not. + Returns [code]true[/code] if the given line is breakpointed. See [method set_line_as_breakpoint]. - Returns whether the line at the specified index is a code region end. + Returns [code]true[/code] if the given line is a code region end. See [method set_code_region_tags]. - Returns whether the line at the specified index is a code region start. + Returns [code]true[/code] if the given line is a code region start. See [method set_code_region_tags]. - Returns whether the line at the specified index is marked as executing or not. + Returns [code]true[/code] if the given line is marked as executing. See [method set_line_as_executing]. - Returns whether the line at the specified index is folded or not. + Returns [code]true[/code] if the given line is folded. See [method fold_line]. @@ -442,7 +442,7 @@ - Sets if the code hint should draw below the text. + If [code]true[/code], the code hint will draw below the main caret. If [code]false[/code], the code hint will draw above the main caret. See [method set_code_hint]. @@ -458,7 +458,7 @@ - Sets the line as bookmarked. + Sets the given line as bookmarked. If [code]true[/code] and [member gutters_draw_bookmarks] is [code]true[/code], draws the [theme_item bookmark] icon in the gutter for this line. See [method get_bookmarked_lines] and [method is_line_bookmarked]. @@ -466,7 +466,7 @@ - Sets the line as breakpointed. + Sets the given line as a breakpoint. If [code]true[/code] and [member gutters_draw_breakpoints_gutter] is [code]true[/code], draws the [theme_item breakpoint] icon in the gutter for this line. See [method get_breakpointed_lines] and [method is_line_breakpointed]. @@ -474,7 +474,7 @@ - Sets the line as executing. + Sets the given line as executing. If [code]true[/code] and [member gutters_draw_executing_lines] is [code]true[/code], draws the [theme_item executing_line] icon in the gutter for this line. See [method get_executing_lines] and [method is_line_executing]. @@ -500,20 +500,20 @@ - Unfolds all lines, folded or not. + Unfolds all lines that are folded. - Unfolds all lines that were previously folded. + Unfolds the given line if it is folded or if it is hidden under a folded line. - Unindents selected lines, or in the case of no selection the caret line by one. Same as performing "ui_text_unindent" action. + Unindents all lines that are selected or have a caret on them. Uses spaces or a tab depending on [member indent_use_spaces]. Equivalent to the [member ProjectSettings.input/ui_text_dedent] action. See [method indent_lines]. @@ -527,16 +527,16 @@ - Sets whether brace pairs should be autocompleted. + If [code]true[/code], uses [member auto_brace_completion_pairs] to automatically insert the closing brace when the opening brace is inserted by typing or autocompletion. Also automatically removes the closing brace when using backspace on the opening brace. - Highlight mismatching brace pairs. + If [code]true[/code], highlights brace pairs when the caret is on either one, using [member auto_brace_completion_pairs]. If matching, the pairs will be underlined. If a brace is unmatched, it is colored with [theme_item brace_mismatch_color]. - Sets the brace pairs to be autocompleted. + Sets the brace pairs to be autocompleted. For each entry in the dictionary, the key is the opening brace and the value is the closing brace that matches it. A brace is a [String] made of symbols. See [member auto_brace_completion_enabled] and [member auto_brace_completion_highlight_matching]. - Sets whether code completion is allowed. + If [code]true[/code], the [member ProjectSettings.input/ui_text_completion_query] action requests code completion. To handle it, see [method _request_code_completion] or [signal code_completion_requested]. Sets prefixes that will trigger code completion. @@ -548,28 +548,28 @@ Sets the string delimiters. All existing string delimiters will be removed. - Sets if bookmarked should be drawn in the gutter. This gutter is shared with breakpoints and executing lines. + If [code]true[/code], bookmarks are drawn in the gutter. This gutter is shared with breakpoints and executing lines. See [method set_line_as_bookmarked]. - Sets if breakpoints should be drawn in the gutter. This gutter is shared with bookmarks and executing lines. + If [code]true[/code], breakpoints are drawn in the gutter. This gutter is shared with bookmarks and executing lines. Clicking the gutter will toggle the breakpoint for the line, see [method set_line_as_breakpoint]. - Sets if executing lines should be marked in the gutter. This gutter is shared with breakpoints and bookmarks lines. + If [code]true[/code], executing lines are marked in the gutter. This gutter is shared with breakpoints and bookmarks. See [method set_line_as_executing]. - Sets if foldable lines icons should be drawn in the gutter. + If [code]true[/code], the fold gutter is drawn. In this gutter, the [theme_item can_fold_code_region] icon is drawn for each foldable line (see [method can_fold_line]) and the [theme_item folded_code_region] icon is drawn for each folded line (see [method is_line_folded]). These icons can be clicked to toggle the fold state, see [method toggle_foldable_line]. [member line_folding] must be [code]true[/code] to show icons. - Sets if line numbers should be drawn in the gutter. + If [code]true[/code], the line number gutter is drawn. Line numbers start at [code]1[/code] and are incremented for each line of text. Clicking and dragging in the line number gutter will select entire lines of text. - Sets if line numbers drawn in the gutter are zero padded. + If [code]true[/code], line numbers drawn in the gutter are zero padded based on the total line count. Requires [member gutters_draw_line_numbers] to be set to [code]true[/code]. - Sets whether automatic indent are enabled, this will add an extra indent if a prefix or brace is found. + If [code]true[/code], an extra indent is automatically inserted when a new line is added and a prefix in [member indent_automatic_prefixes] is found. If a brace pair opening key is found, the matching closing brace will be moved to another new line (see [member auto_brace_completion_pairs]). - Prefixes to trigger an automatic indent. + Prefixes to trigger an automatic indent. Used when [member indent_automatic] is set to [code]true[/code]. Size of the tabulation indent (one [kbd]Tab[/kbd] press) in characters. If [member indent_use_spaces] is enabled the number of spaces to use. @@ -579,7 +579,7 @@ - Sets whether line folding is allowed. + If [code]true[/code], lines can be folded. Otherwise, line folding methods like [method fold_line] will not work and [method can_fold_line] will always return [code]false[/code]. See [member gutters_draw_fold_gutter]. Draws vertical lines at the provided columns. The first entry is considered a main hard guideline and is draw more prominently. @@ -598,7 +598,7 @@ - Emitted when the user requests code completion. + Emitted when the user requests code completion. This signal will not be sent if [method _request_code_completion] is overridden or [member code_completion_enabled] is [code]false[/code]. diff --git a/doc/classes/EditorSettings.xml b/doc/classes/EditorSettings.xml index c35a376c854..ea987da6f5f 100644 --- a/doc/classes/EditorSettings.xml +++ b/doc/classes/EditorSettings.xml @@ -1275,7 +1275,7 @@ If [code]true[/code], adds [url=$DOCS_URL/tutorials/scripting/gdscript/static_typing.html]GDScript static typing[/url] hints such as [code]-> void[/code] and [code]: int[/code] when using code autocompletion or when creating onready variables by drag and dropping nodes into the script editor while pressing the [kbd]Ctrl[/kbd] key. If [code]true[/code], newly created scripts will also automatically have type hints added to their method parameters and return types. - If [code]true[/code], automatically completes braces when making use of code completion. + If [code]true[/code], automatically inserts the matching closing brace when the opening brace is inserted by typing or autocompletion. Also automatically removes the closing brace when pressing [kbd]Backspace[/kbd] on the opening brace. This includes brackets ([code]()[/code], [code][][/code], [code]{}[/code]), string quotation marks ([code]''[/code], [code]""[/code]), and comments ([code]/**/[/code]) if the language supports it. The delay in seconds after which autocompletion suggestions should be displayed when the user stops typing. diff --git a/doc/classes/TextEdit.xml b/doc/classes/TextEdit.xml index 13721d9d62b..b884fa59586 100644 --- a/doc/classes/TextEdit.xml +++ b/doc/classes/TextEdit.xml @@ -265,7 +265,7 @@ - Returns the first column containing a non-whitespace character. + Returns the first column containing a non-whitespace character on the given line. If there is only whitespace, returns the number of characters. @@ -311,7 +311,7 @@ - Returns the number of spaces and [code]tab * tab_size[/code] before the first char. + Returns the indent level of the given line. This is the number of spaces and tabs at the beginning of the line, with the tabs taking the tab size into account (see [method get_tab_size]). @@ -343,7 +343,7 @@ - Returns the current background color of the line. [code]Color(0, 0, 0, 0)[/code] is returned if no color is set. + Returns the custom background color of the given line. If no color is set, returns [code]Color(0, 0, 0, 0)[/code]. @@ -428,7 +428,7 @@ - Returns the wrap index of the given line column. + Returns the wrap index of the given column on the given line. This ranges from [code]0[/code] to [method get_line_wrap_count]. @@ -655,7 +655,7 @@ - Returns the number of lines that may be drawn. + Returns the total number of lines in the text. This includes wrapped lines and excludes folded lines. If [member wrap_mode] is set to [constant LINE_WRAPPING_NONE] and no lines are folded (see [method CodeEdit.is_line_folded]) then this is equivalent to [method get_line_count]. See [method get_visible_line_count_in_range] for a limited range of lines. @@ -673,7 +673,7 @@ - Returns the number of visible lines, including wrapped text. + Returns the number of lines that can visually fit, rounded down, based on this control's height. @@ -681,7 +681,7 @@ - Returns the total number of visible + wrapped lines between the two lines. + Returns the total number of lines between [param from_line] and [param to_line] (inclusive) in the text. This includes wrapped lines and excludes folded lines. If the range covers all lines it is equivalent to [method get_total_visible_line_count]. @@ -777,21 +777,21 @@ - Returns whether the gutter is clickable. + Returns [code]true[/code] if the gutter at the given index is clickable. See [method set_gutter_clickable]. - Returns whether the gutter is currently drawn. + Returns [code]true[/code] if the gutter at the given index is currently drawn. See [method set_gutter_draw]. - Returns whether the gutter is overwritable. + Returns [code]true[/code] if the gutter at the given index is overwritable. See [method set_gutter_overwritable]. @@ -805,7 +805,7 @@ - Returns whether the gutter on the given line is clickable. + Returns [code]true[/code] if the gutter at the given index on the given line is clickable. See [method set_line_gutter_clickable]. @@ -818,7 +818,7 @@ - Returns whether the menu is visible. Use this instead of [code]get_menu().visible[/code] to improve performance (so the creation of the menu is avoided). + Returns [code]true[/code] if the menu is visible. Use this instead of [code]get_menu().visible[/code] to improve performance (so the creation of the menu is avoided). See [method get_menu]. @@ -826,13 +826,13 @@ - Returns whether the mouse is over selection. If [param edges] is [code]true[/code], the edges are considered part of the selection. + Returns [code]true[/code] if the mouse is over a selection. If [param edges] is [code]true[/code], the edges are considered part of the selection. - Returns whether the user is in overtype mode. + Returns [code]true[/code] if overtype mode is enabled. See [method set_overtype_mode_enabled]. @@ -847,7 +847,7 @@ - Merge the gutters from [param from_line] into [param to_line]. Only overwritable gutters will be copied. + Merge the gutters from [param from_line] into [param to_line]. Only overwritable gutters will be copied. See [method set_gutter_overwritable]. @@ -898,7 +898,7 @@ - Removes the gutter from this [TextEdit]. + Removes the gutter at the given index. @@ -1013,7 +1013,7 @@ - Sets the gutter as clickable. This will change the mouse cursor to a pointing hand when hovering over the gutter. + If [code]true[/code], the mouse cursor will change to a pointing hand ([constant Control.CURSOR_POINTING_HAND]) when hovering over the gutter at the given index. See [method is_gutter_clickable] and [method set_line_gutter_clickable]. @@ -1021,7 +1021,7 @@ - Set a custom draw method for the gutter. The callback method must take the following args: [code]line: int, gutter: int, Area: Rect2[/code]. This only works when the gutter type is [constant GUTTER_TYPE_CUSTOM] (see [method set_gutter_type]). + Set a custom draw callback for the gutter at the given index. [param draw_callback] must take the following arguments: A line index [int], a gutter index [int], and an area [Rect2]. This callback only works when the gutter type is [constant GUTTER_TYPE_CUSTOM] (see [method set_gutter_type]). @@ -1029,7 +1029,7 @@ - Sets whether the gutter should be drawn. + If [code]true[/code], the gutter at the given index is drawn. The gutter type ([method set_gutter_type]) determines how it is drawn. See [method is_gutter_drawn]. @@ -1037,7 +1037,7 @@ - Sets the name of the gutter. + Sets the name of the gutter at the given index. @@ -1045,7 +1045,7 @@ - Sets the gutter to overwritable. See [method merge_gutters]. + If [code]true[/code], the line data of the gutter at the given index can be overridden when using [method merge_gutters]. See [method is_gutter_overwritable]. @@ -1053,7 +1053,7 @@ - Sets the type of gutter. Gutters can contain icons, text, or custom visuals. See [enum TextEdit.GutterType] for options. + Sets the type of gutter at the given index. Gutters can contain icons, text, or custom visuals. See [enum TextEdit.GutterType] for options. @@ -1061,7 +1061,7 @@ - Set the width of the gutter. + Set the width of the gutter at the given index. @@ -1102,7 +1102,7 @@ - Sets the current background color of the line. Set to [code]Color(0, 0, 0, 0)[/code] for no color. + Sets the custom background color of the given line. If transparent, this color is applied on top of the default background color (See [theme_item background_color]). If set to [code]Color(0, 0, 0, 0)[/code], no additional color is applied. @@ -1111,7 +1111,7 @@ - If [param clickable] is [code]true[/code], makes the [param gutter] on [param line] clickable. See [signal gutter_clicked]. + If [param clickable] is [code]true[/code], makes the [param gutter] on the given [param line] clickable. This is like [method set_gutter_clickable], but for a single line. If [method is_gutter_clickable] is [code]true[/code], this will not have any effect. See [method is_line_gutter_clickable] and [signal gutter_clicked]. @@ -1154,7 +1154,7 @@ - If [code]true[/code], sets the user into overtype mode. When the user types in this mode, it will override existing text. + If [code]true[/code], enables overtype mode. In this mode, typing overrides existing text instead of inserting text. The [member ProjectSettings.input/ui_text_toggle_insert_mode] action toggles overtype mode. See [method is_overtype_mode_enabled]. @@ -1269,7 +1269,7 @@ If [code]false[/code], the context menu ignores mouse location. - Sets if multiple carets are allowed. + If [code]true[/code], multiple carets are allowed. Left-clicking with [kbd]Alt[/kbd] adds a new caret. See [method add_caret] and [method get_caret_count]. Set the type of caret to draw.