Support AddSlideOut and DialogLauncher

Author: ricaun

CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] / 2025-07-18
+### Features
+- Support `AddSlideOut` extension.
+- Support `SetDialogLauncher` and `GetDialogLauncher` extensions.
+### UI
+- Update `RibbonExtension` to support `AddSlideOut`.
+- Update `RibbonExtension` to support `SetDialogLauncher` and `GetDialogLauncher`.
+
 ## [0.3.0] / 2025-07-15
 ### Features
 - Support `CreateSplitButton` extension.
@@ -46,6 +54,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Add `Busy`, `Runtime`, `Tasks`, and `Windows` utilities.
 
 [vNext]: ../../compare/1.0.0...HEAD
+[0.4.0]: ../../compare/0.3.0...0.4.0
 [0.3.0]: ../../compare/0.2.0...0.3.0
 [0.2.0]: ../../compare/0.1.0...0.2.0
 [0.1.0]: ../../compare/0.1.0

Directory.Build.props

@@ -1,5 +1,5 @@
 <Project>
 	<PropertyGroup>
-		<Version>0.3.0</Version>
+		<Version>0.4.0-alpha</Version>
 	</PropertyGroup>
 </Project>

ricaun.AutoCAD.UI.Example/App.cs

@@ -116,6 +116,18 @@ await autoCADTask.Run(() =>
             .SetLargeImage("Resources/Cube-Green-Light.tiff")
             .SetDescription("This is a PulldownButton");
 
+            ribbonPanel.AddSlideOut();
+            ribbonPanel.RowStackedItems(
+                ribbonPanel.CreateButton("1")
+                    .SetLargeImage("Resources/Cube-Grey-Light.tiff"),
+                ribbonPanel.CreateButton("2")
+                    .SetLargeImage("Resources/Cube-Grey-Light.tiff"),
+                ribbonPanel.CreateButton("3")
+                    .SetLargeImage("Resources/Cube-Grey-Light.tiff")
+            );
+
+            ribbonPanel.SetDialogLauncher(ribbonPanel.CreateButton("DialogLauncher").SetCommand(e => Windows.MessageBox.ShowMessage(e.Text)));
+
             ribbonControl.ActiveTab = ribbonPanel.Tab;
         }
         public override void OnShutdown(RibbonControl ribbonControl)

ricaun.AutoCAD.UI/RibbonExtension.cs

@@ -522,6 +522,45 @@ public static RibbonPanel AddSeparator(this RibbonPanel ribbonPanel)
             return ribbonPanel;
         }
 
+        /// <summary>
+        /// Adds a slide-out (panel break) to the ribbon panel.
+        /// </summary>
+        /// <param name="ribbonPanel">The ribbon panel to extend.</param>
+        /// <returns>The ribbon panel with the slide-out added.</returns>
+        public static RibbonPanel AddSlideOut(this RibbonPanel ribbonPanel)
+        {
+            if (ribbonPanel is null) return ribbonPanel;
+            ribbonPanel.AddItem(new RibbonPanelBreak());
+            return ribbonPanel;
+        }
+
+        /// <summary>
+        /// Sets the dialog launcher for the specified <see cref="RibbonPanel"/>.
+        /// </summary>
+        /// <param name="ribbonPanel">The ribbon panel to set the dialog launcher for.</param>
+        /// <param name="ribbonItem">The <see cref="RibbonCommandItem"/> to use as the dialog launcher.</param>
+        /// <returns>The <see cref="RibbonPanel"/> with the dialog launcher set.</returns>
+        public static RibbonPanel SetDialogLauncher(this RibbonPanel ribbonPanel, RibbonCommandItem ribbonItem)
+        {
+            if (ribbonPanel is null) return ribbonPanel;
+            ribbonPanel.Source.DialogLauncher = ribbonItem;
+            ribbonPanel.Remove(ribbonItem);
+            return ribbonPanel;
+        }
+
+        /// <summary>
+        /// Gets the dialog launcher <see cref="RibbonCommandItem"/> for the specified <see cref="RibbonPanel"/>.
+        /// </summary>
+        /// <param name="ribbonPanel">The ribbon panel to retrieve the dialog launcher from.</param>
+        /// <returns>
+        /// The <see cref="RibbonCommandItem"/> set as the dialog launcher for the panel, or <c>null</c> if the panel is <c>null</c>.
+        /// </returns>
+        public static RibbonCommandItem GetDialogLauncher(this RibbonPanel ribbonPanel)
+        {
+            if (ribbonPanel is null) return null;
+            return ribbonPanel.Source.DialogLauncher;
+        }
+
         #region RibbonListButton
 
         /// <summary>