From 5c618dd03dd4fe1ada234e91a08bcf12eb8f7aa7 Mon Sep 17 00:00:00 2001
From: Paulb23 <p_batty@hotmail.co.uk>
Date: Sat, 13 Mar 2021 14:09:49 +0000
Subject: Move code folding into CodeEdit and hide line hiding API

---
 doc/classes/CodeEdit.xml | 70 +++++++++++++++++++++++++++++++++++++++
 doc/classes/TextEdit.xml | 86 +-----------------------------------------------
 2 files changed, 71 insertions(+), 85 deletions(-)

(limited to 'doc')

diff --git a/doc/classes/CodeEdit.xml b/doc/classes/CodeEdit.xml
index 4076198df6..fcd36447c5 100644
--- a/doc/classes/CodeEdit.xml
+++ b/doc/classes/CodeEdit.xml
@@ -86,6 +86,15 @@
 				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="can_fold_line" qualifiers="const">
+			<return type="bool">
+			</return>
+			<argument index="0" name="line" type="int">
+			</argument>
+			<description>
+				Returns if the given line is foldable, that is, it has indented lines right below it or a comment / string block.
+			</description>
+		</method>
 		<method name="cancel_code_completion">
 			<return type="void">
 			</return>
@@ -134,6 +143,22 @@
 				Inserts the selected entry into the text. If [code]replace[/code] is true, any existing text is replaced rather then merged.
 			</description>
 		</method>
+		<method name="fold_all_lines">
+			<return type="void">
+			</return>
+			<description>
+				Folds all lines that are possible to be folded (see [method can_fold_line]).
+			</description>
+		</method>
+		<method name="fold_line">
+			<return type="void">
+			</return>
+			<argument index="0" name="line" type="int">
+			</argument>
+			<description>
+				Folds the given line, if possible (see [method can_fold_line]).
+			</description>
+		</method>
 		<method name="get_bookmarked_lines" qualifiers="const">
 			<return type="Array">
 			</return>
@@ -221,6 +246,13 @@
 			<description>
 			</description>
 		</method>
+		<method name="get_folded_lines" qualifiers="const">
+			<return type="int[]">
+			</return>
+			<description>
+				Return all lines that are current folded.
+			</description>
+		</method>
 		<method name="get_text_for_code_completion" qualifiers="const">
 			<return type="String">
 			</return>
@@ -292,6 +324,15 @@
 			<description>
 			</description>
 		</method>
+		<method name="is_line_folded" qualifiers="const">
+			<return type="bool">
+			</return>
+			<argument index="0" name="line" type="int">
+			</argument>
+			<description>
+				Returns whether the line at the specified index is folded or not.
+			</description>
+		</method>
 		<method name="remove_comment_delimiter">
 			<return type="void">
 			</return>
@@ -376,6 +417,30 @@
 			<description>
 			</description>
 		</method>
+		<method name="toggle_foldable_line">
+			<return type="void">
+			</return>
+			<argument index="0" name="line" type="int">
+			</argument>
+			<description>
+				Toggle the folding of the code block at the given line.
+			</description>
+		</method>
+		<method name="unfold_all_lines">
+			<return type="void">
+			</return>
+			<description>
+			</description>
+		</method>
+		<method name="unfold_line">
+			<return type="void">
+			</return>
+			<argument index="0" name="line" type="int">
+			</argument>
+			<description>
+				Unfolds all lines that were previously folded.
+			</description>
+		</method>
 		<method name="update_code_completion_options">
 			<return type="void">
 			</return>
@@ -411,6 +476,9 @@
 		<member name="draw_line_numbers" type="bool" setter="set_draw_line_numbers" getter="is_draw_line_numbers_enabled" default="false">
 		</member>
 		<member name="layout_direction" type="int" setter="set_layout_direction" getter="get_layout_direction" override="true" enum="Control.LayoutDirection" default="2" />
+		<member name="line_folding" type="bool" setter="set_line_folding_enabled" getter="is_line_folding_enabled" default="true">
+			Sets whether line folding is allowed.
+		</member>
 		<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" />
 		<member name="zero_pad_line_numbers" type="bool" setter="set_line_numbers_zero_padded" getter="is_line_numbers_zero_padded" default="false">
@@ -500,6 +568,8 @@
 		</theme_item>
 		<theme_item name="folded" type="Texture2D">
 		</theme_item>
+		<theme_item name="folded_eol_icon" 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 )">
diff --git a/doc/classes/TextEdit.xml b/doc/classes/TextEdit.xml
index 74811318dc..2d6a052fe3 100644
--- a/doc/classes/TextEdit.xml
+++ b/doc/classes/TextEdit.xml
@@ -18,15 +18,6 @@
 			<description>
 			</description>
 		</method>
-		<method name="can_fold" qualifiers="const">
-			<return type="bool">
-			</return>
-			<argument index="0" name="line" type="int">
-			</argument>
-			<description>
-				Returns if the given line is foldable, that is, it has indented lines right below it.
-			</description>
-		</method>
 		<method name="center_viewport_to_cursor">
 			<return type="void">
 			</return>
@@ -95,7 +86,7 @@
 			<description>
 				Moves the cursor at the specified [code]line[/code] index.
 				If [code]adjust_viewport[/code] is set to [code]true[/code], the viewport will center at the cursor position after the move occurs.
-				If [code]can_be_hidden[/code] is set to [code]true[/code], the specified [code]line[/code] can be hidden using [method set_line_as_hidden].
+				If [code]can_be_hidden[/code] is set to [code]true[/code], the specified [code]line[/code] can be hidden.
 			</description>
 		</method>
 		<method name="cut">
@@ -112,22 +103,6 @@
 				Deselects the current selection.
 			</description>
 		</method>
-		<method name="fold_all_lines">
-			<return type="void">
-			</return>
-			<description>
-				Folds all lines that are possible to be folded (see [method can_fold]).
-			</description>
-		</method>
-		<method name="fold_line">
-			<return type="void">
-			</return>
-			<argument index="0" name="line" type="int">
-			</argument>
-			<description>
-				Folds the given line, if possible (see [method can_fold]).
-			</description>
-		</method>
 		<method name="get_caret_draw_pos" qualifiers="const">
 			<return type="Vector2">
 			</return>
@@ -329,15 +304,6 @@
 				Returns [code]true[/code] if the caret is visible on the screen.
 			</description>
 		</method>
-		<method name="is_folded" qualifiers="const">
-			<return type="bool">
-			</return>
-			<argument index="0" name="line" type="int">
-			</argument>
-			<description>
-				Returns whether the line at the specified index is folded or not.
-			</description>
-		</method>
 		<method name="is_gutter_clickable" qualifiers="const">
 			<return type="bool">
 			</return>
@@ -372,15 +338,6 @@
 			<description>
 			</description>
 		</method>
-		<method name="is_line_hidden" qualifiers="const">
-			<return type="bool">
-			</return>
-			<argument index="0" name="line" type="int">
-			</argument>
-			<description>
-				Returns whether the line at the specified index is hidden or not.
-			</description>
-		</method>
 		<method name="is_selection_active" qualifiers="const">
 			<return type="bool">
 			</return>
@@ -560,17 +517,6 @@
 				Sets the text for a specific line.
 			</description>
 		</method>
-		<method name="set_line_as_hidden">
-			<return type="void">
-			</return>
-			<argument index="0" name="line" type="int">
-			</argument>
-			<argument index="1" name="enable" type="bool">
-			</argument>
-			<description>
-				If [code]true[/code], hides the line of the specified index.
-			</description>
-		</method>
 		<method name="set_line_background_color">
 			<return type="void">
 			</return>
@@ -665,15 +611,6 @@
 			<description>
 			</description>
 		</method>
-		<method name="toggle_fold_line">
-			<return type="void">
-			</return>
-			<argument index="0" name="line" type="int">
-			</argument>
-			<description>
-				Toggle the folding of the code block at the given line.
-			</description>
-		</method>
 		<method name="undo">
 			<return type="void">
 			</return>
@@ -681,22 +618,6 @@
 				Perform undo operation.
 			</description>
 		</method>
-		<method name="unfold_line">
-			<return type="void">
-			</return>
-			<argument index="0" name="line" type="int">
-			</argument>
-			<description>
-				Unfolds the given line, if folded.
-			</description>
-		</method>
-		<method name="unhide_all_lines">
-			<return type="void">
-			</return>
-			<description>
-				Unhide all lines that were previously set to hidden by [method set_line_as_hidden].
-			</description>
-		</method>
 	</methods>
 	<members>
 		<member name="caret_blink" type="bool" setter="cursor_set_blink_enabled" getter="cursor_get_blink_enabled" default="false">
@@ -730,9 +651,6 @@
 			If [code]true[/code], the "tab" character will have a visible representation.
 		</member>
 		<member name="focus_mode" type="int" setter="set_focus_mode" getter="get_focus_mode" override="true" enum="Control.FocusMode" default="2" />
-		<member name="hiding_enabled" type="bool" setter="set_hiding_enabled" getter="is_hiding_enabled" default="false">
-			If [code]true[/code], all lines that have been set to hidden by [method set_line_as_hidden], will not be visible.
-		</member>
 		<member name="highlight_all_occurrences" type="bool" setter="set_highlight_all_occurrences" getter="is_highlight_all_occurrences_enabled" default="false">
 			If [code]true[/code], all occurrences of the selected text will be highlighted.
 		</member>
@@ -972,8 +890,6 @@
 		</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="current_line_color" type="Color" default="Color( 0.25, 0.25, 0.26, 0.8 )">
 			Sets the [Color] of the breakpoints. [member breakpoint_gutter] has to be enabled.
 		</theme_item>
-- 
cgit v1.2.3