From 5a1b31e8a3b160fcdf9431dfc55bcdd98808bc3f Mon Sep 17 00:00:00 2001
From: Ellpeck <me@ellpeck.de>
Date: Tue, 3 May 2022 19:07:53 +0200
Subject: [PATCH] Allow adding dropdown and tooltip elements at a specified
 index

---
 CHANGELOG.md                 |  1 +
 MLEM.Ui/Elements/Dropdown.cs | 15 +++++++++------
 MLEM.Ui/Elements/Tooltip.cs  | 17 ++++++++++-------
 3 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 72aadc3..17549d9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -24,6 +24,7 @@ Improvements
 - Started using SpriteBatchContext for Draw and DrawTransformed methods
 - Make use of the new consuming variants in InputHandler and Keybind to consume UiControls inputs
 - Allow Tooltip to manage more than one paragraph and make it easier to add new lines
+- Allow adding dropdown elements at a specified index
 
 Fixes
 - Fixed auto-nav tooltip displaying on the selected element even when not in auto-nav mode
diff --git a/MLEM.Ui/Elements/Dropdown.cs b/MLEM.Ui/Elements/Dropdown.cs
index 8f4f25e..3825c00 100644
--- a/MLEM.Ui/Elements/Dropdown.cs
+++ b/MLEM.Ui/Elements/Dropdown.cs
@@ -55,8 +55,9 @@ namespace MLEM.Ui.Elements {
         /// Adds an element to this dropdown's <see cref="Panel"/>
         /// </summary>
         /// <param name="element">The element to add</param>
-        public void AddElement(Element element) {
-            this.Panel.AddChild(element);
+        /// <param name="index">The index to add the child at, or -1 to add it to the end of the <see cref="Element.Children"/> list</param>
+        public void AddElement(Element element, int index = -1) {
+            this.Panel.AddChild(element, index);
             // Since the dropdown causes elements to be over each other,
             // usual gamepad code doesn't apply
             element.GetGamepadNextElement = (dir, usualNext) => {
@@ -77,8 +78,9 @@ namespace MLEM.Ui.Elements {
         /// </summary>
         /// <param name="text">The text to display</param>
         /// <param name="pressed">The resulting paragraph's <see cref="Element.OnPressed"/> event</param>
-        public Element AddElement(string text, GenericCallback pressed = null) {
-            return this.AddElement(p => text, pressed);
+        /// <param name="index">The index to add the child at, or -1 to add it to the end of the <see cref="Element.Children"/> list</param>
+        public Element AddElement(string text, GenericCallback pressed = null, int index = -1) {
+            return this.AddElement(p => text, pressed, index);
         }
 
         /// <summary>
@@ -87,7 +89,8 @@ namespace MLEM.Ui.Elements {
         /// </summary>
         /// <param name="text">The text to display</param>
         /// <param name="pressed">The resulting paragraph's <see cref="Element.OnPressed"/> event</param>
-        public Element AddElement(Paragraph.TextCallback text, GenericCallback pressed = null) {
+        /// <param name="index">The index to add the child at, or -1 to add it to the end of the <see cref="Element.Children"/> list</param>
+        public Element AddElement(Paragraph.TextCallback text, GenericCallback pressed = null, int index = -1) {
             var paragraph = new Paragraph(Anchor.AutoLeft, 1, text) {
                 CanBeMoused = true,
                 CanBeSelected = true,
@@ -97,7 +100,7 @@ namespace MLEM.Ui.Elements {
                 paragraph.OnPressed += pressed;
             paragraph.OnMouseEnter += e => paragraph.TextColor = Color.LightGray;
             paragraph.OnMouseExit += e => paragraph.TextColor = Color.White;
-            this.AddElement(paragraph);
+            this.AddElement(paragraph, index);
             return paragraph;
         }
 
diff --git a/MLEM.Ui/Elements/Tooltip.cs b/MLEM.Ui/Elements/Tooltip.cs
index 1f64fee..d69f34f 100644
--- a/MLEM.Ui/Elements/Tooltip.cs
+++ b/MLEM.Ui/Elements/Tooltip.cs
@@ -15,7 +15,7 @@ namespace MLEM.Ui.Elements {
         /// <summary>
         /// A list of <see cref="Elements.Paragraph"/> objects that this tooltip automatically manages.
         /// A paragraph that is contained in this list will automatically have the <see cref="UiStyle.TooltipTextWidth"/> and <see cref="UiStyle.TooltipTextColor"/> applied.
-        /// To add a paragraph to both this list and to <see cref="Element.Children"/>, use <see cref="AddParagraph(Elements.Paragraph)"/>.
+        /// To add a paragraph to both this list and to <see cref="Element.Children"/>, use <see cref="AddParagraph(Elements.Paragraph,int)"/>.
         /// </summary>
         public readonly List<Paragraph> Paragraphs = new List<Paragraph>();
 
@@ -132,9 +132,10 @@ namespace MLEM.Ui.Elements {
         /// </summary>
         /// <param name="paragraph">The paragraph to add</param>
         /// <returns>The added paragraph, for chaining</returns>
-        public Paragraph AddParagraph(Paragraph paragraph) {
+        /// <param name="index">The index to add the child at, or -1 to add it to the end of the <see cref="Element.Children"/> list</param>
+        public Paragraph AddParagraph(Paragraph paragraph, int index = -1) {
             this.Paragraphs.Add(paragraph);
-            this.AddChild(paragraph);
+            this.AddChild(paragraph, index);
             if (this.Style.HasValue())
                 SetParagraphStyle(paragraph, this.Style);
             return paragraph;
@@ -146,8 +147,9 @@ namespace MLEM.Ui.Elements {
         /// </summary>
         /// <param name="text">The text that the paragraph should display</param>
         /// <returns>The created paragraph, for chaining</returns>
-        public Paragraph AddParagraph(Paragraph.TextCallback text) {
-            return this.AddParagraph(new Paragraph(Anchor.AutoLeft, 0, text));
+        /// <param name="index">The index to add the child at, or -1 to add it to the end of the <see cref="Element.Children"/> list</param>
+        public Paragraph AddParagraph(Paragraph.TextCallback text, int index = -1) {
+            return this.AddParagraph(new Paragraph(Anchor.AutoLeft, 0, text), index);
         }
 
         /// <summary>
@@ -156,8 +158,9 @@ namespace MLEM.Ui.Elements {
         /// </summary>
         /// <param name="text">The text that the paragraph should display</param>
         /// <returns>The created paragraph, for chaining</returns>
-        public Paragraph AddParagraph(string text) {
-            return this.AddParagraph(p => text);
+        /// <param name="index">The index to add the child at, or -1 to add it to the end of the <see cref="Element.Children"/> list</param>
+        public Paragraph AddParagraph(string text, int index = -1) {
+            return this.AddParagraph(p => text, index);
         }
 
         /// <summary>