SetCursorPosition: can specify desired cursor line location on the page

* SetCursorPosition(aPosition) : behaves as before
* SetCursorPosition(aPosition, 3): will change the cursor position, and then
on the subsequent call to EnsureCursorIsVisible(), will make the cursor line appear as the third line on the page.

Author: pthom

TextEditor.cpp

@@ -32,6 +32,7 @@ TextEditor::TextEditor()
 	, mReadOnly(false)
 	, mWithinRender(false)
 	, mScrollToCursor(false)
+	, mScrollToCursor_CursorLineOnPage(-1)
 	, mScrollToTop(false)
 	, mTextChanged(false)
 	, mColorizerEnabled(true)
@@ -1394,13 +1395,13 @@ void TextEditor::SetColorizerEnable(bool aValue)
 	mColorizerEnabled = aValue;
 }
 
-void TextEditor::SetCursorPosition(const Coordinates & aPosition)
+void TextEditor::SetCursorPosition(const Coordinates & aPosition, unsigned int cursorLineOnPage)
 {
 	if (mState.mCursorPosition != aPosition)
 	{
 		mState.mCursorPosition = aPosition;
 		mCursorPositionChanged = true;
-		EnsureCursorVisible();
+		EnsureCursorVisible(cursorLineOnPage);
 	}
 }
 
@@ -2418,11 +2419,12 @@ float TextEditor::TextDistanceToLineStart(const Coordinates& aFrom) const
 	return distance;
 }
 
-void TextEditor::EnsureCursorVisible()
+void TextEditor::EnsureCursorVisible(unsigned int cursorLineOnPage)
 {
 	if (!mWithinRender)
 	{
 		mScrollToCursor = true;
+        mScrollToCursor_CursorLineOnPage = cursorLineOnPage;
 		return;
 	}
 
@@ -2441,10 +2443,17 @@ void TextEditor::EnsureCursorVisible()
 	auto pos = GetActualCursorCoordinates();
 	auto len = TextDistanceToLineStart(pos);
 
-	if (pos.mLine < top)
-		ImGui::SetScrollY(std::max(0.0f, (pos.mLine - 1) * mCharAdvance.y));
-	if (pos.mLine > bottom - 4)
-		ImGui::SetScrollY(std::max(0.0f, (pos.mLine + 4) * mCharAdvance.y - height));
+	if (mScrollToCursor_CursorLineOnPage >= 0)
+    {
+        ImGui::SetScrollY(std::max(0.0f, (pos.mLine - mScrollToCursor_CursorLineOnPage) * mCharAdvance.y));
+    }
+    else
+    {
+        if (pos.mLine < top)
+            ImGui::SetScrollY(std::max(0.0f, (pos.mLine - 1) * mCharAdvance.y));
+        if (pos.mLine > bottom - 4)
+            ImGui::SetScrollY(std::max(0.0f, (pos.mLine + 4) * mCharAdvance.y - height));
+    }
 	if (len + mTextStart < left + 4)
 		ImGui::SetScrollX(std::max(0.0f, len + mTextStart - 4));
 	if (len + mTextStart > right - 4)

TextEditor.h

@@ -216,7 +216,7 @@ class TextEditor
 	void SetColorizerEnable(bool aValue);
 
 	Coordinates GetCursorPosition() const { return GetActualCursorCoordinates(); }
-	void SetCursorPosition(const Coordinates& aPosition);
+	void SetCursorPosition(const Coordinates& aPosition, unsigned int cursorLineOnPage = -1);
 
 	inline void SetHandleMouseInputs    (bool aValue){ mHandleMouseInputs    = aValue;}
 	inline bool IsHandleMouseInputsEnabled() const { return mHandleKeyboardInputs; }
@@ -316,7 +316,7 @@ class TextEditor
 	void ColorizeRange(int aFromLine = 0, int aToLine = 0);
 	void ColorizeInternal();
 	float TextDistanceToLineStart(const Coordinates& aFrom) const;
-	void EnsureCursorVisible();
+	void EnsureCursorVisible(unsigned int cursorLineOnPage = -1);
 	int GetPageSize() const;
 	std::string GetText(const Coordinates& aStart, const Coordinates& aEnd) const;
 	Coordinates GetActualCursorCoordinates() const;
@@ -359,6 +359,7 @@ class TextEditor
 	bool mReadOnly;
 	bool mWithinRender;
 	bool mScrollToCursor;
+	int  mScrollToCursor_CursorLineOnPage;
 	bool mScrollToTop;
 	bool mTextChanged;
 	bool mColorizerEnabled;