[SettingsExpander] Adding Expanded/Collapsed events (#382)

* Removing unused comments

* Adding Expanded/Collapsed events

* Adding comments

* Bumping version number

Author: niels9001

components/SettingsControls/samples/SettingsCardSample.xaml.cs

@@ -5,14 +5,6 @@
 namespace SettingsControlsExperiment.Samples;
 
 [ToolkitSampleBoolOption("IsCardEnabled", true, Title = "Is Enabled")]
-// Single values without a colon are used for both label and value.
-// To provide a different label for the value, separate with a colon surrounded by a single space on both sides ("label : value").
-//[ToolkitSampleMultiChoiceOption("TextSize", title: "Text size", "Small : 12", "Normal : 16", "Big : 32")]
-//[ToolkitSampleMultiChoiceOption("TextFontFamily", title: "Font family", "Segoe UI", "Arial", "Consolas")]
-//[ToolkitSampleMultiChoiceOption("TextForeground", title: "Text foreground",
-//    "Teal       : #0ddc8c",
-//    "Sand       : #e7a676",
-//    "Dull green : #5d7577")]
 
 [ToolkitSample(id: nameof(SettingsCardSample), "SettingsCard", description: "A sample for showing how SettingsCard can be static or clickable.")]
 public sealed partial class SettingsCardSample : Page

components/SettingsControls/samples/SettingsExpanderSample.xaml.cs

@@ -7,15 +7,6 @@ namespace SettingsControlsExperiment.Samples;
 [ToolkitSampleBoolOption("IsCardExpanded", false, Title = "Is Expanded")]
 // [ToolkitSampleBoolOption("IsCardEnabled", true, Title = "Is Enabled")] Disabled for now, see: https://github.com/CommunityToolkit/Labs-Windows/issues/362
 
-// Single values without a colon are used for both label and value.
-// To provide a different label for the value, separate with a colon surrounded by a single space on both sides ("label : value").
-//[ToolkitSampleMultiChoiceOption("TextSize", title: "Text size", "Small : 12", "Normal : 16", "Big : 32")]
-//[ToolkitSampleMultiChoiceOption("TextFontFamily", title: "Font family", "Segoe UI", "Arial", "Consolas")]
-//[ToolkitSampleMultiChoiceOption("TextForeground", title: "Text foreground",
-//    "Teal       : #0ddc8c",
-//    "Sand       : #e7a676",
-//    "Dull green : #5d7577")]
-
 [ToolkitSample(id: nameof(SettingsExpanderSample), "SettingsExpander", description: "The SettingsExpander can be used to group settings. SettingsCards can be customized in terms of alignment and content.")]
 public sealed partial class SettingsExpanderSample : Page
 {

components/SettingsControls/src/CommunityToolkit.Labs.WinUI.SettingsControls.csproj

@@ -2,7 +2,7 @@
   <PropertyGroup>
     <ToolkitComponentName>SettingsControls</ToolkitComponentName>
     <Description>This package contains the SettingsCard and SettingsExpander controls.</Description>
-    <Version>0.0.16</Version>
+    <Version>0.0.17</Version>
     <LangVersion>10.0</LangVersion>
 
     <!-- Rns suffix is required for namespaces shared across projects. See https://github.com/CommunityToolkit/Labs-Windows/issues/152 -->

components/SettingsControls/src/SettingsExpander/SettingsExpander.Events.cs

@@ -0,0 +1,17 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+namespace CommunityToolkit.Labs.WinUI;
+public partial class SettingsExpander
+{
+    /// <summary>
+    /// Fires when the SettingsExpander is opened
+    /// </summary>
+    public event EventHandler? Expanded;
+
+    /// <summary>
+    /// Fires when the expander is closed
+    /// </summary>
+    public event EventHandler? Collapsed;
+}

components/SettingsControls/src/SettingsExpander/SettingsExpander.Properties.cs

@@ -140,5 +140,14 @@ public bool IsExpanded
     protected virtual void OnIsExpandedPropertyChanged(bool oldValue, bool newValue)
     {
         OnIsExpandedChanged(oldValue, newValue);
+
+        if (newValue)
+        {
+            Expanded?.Invoke(this, EventArgs.Empty);
+        }
+        else
+        {
+            Collapsed?.Invoke(this, EventArgs.Empty);
+        }
     }
 }