Add mouse clicking debounce sample

Author: michael-hawker

components/Extensions/samples/Dispatcher/MouseDebounceSample.xaml

@@ -0,0 +1,14 @@
+<Page
+    x:Class="ExtensionsExperiment.Samples.DispatcherQueueExtensions.MouseDebounceSample"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    mc:Ignorable="d"
+    Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
+
+    <StackPanel Spacing="8">
+        <Button Click="Button_Click" Content="Click Me"/>
+        <TextBlock x:Name="ResultText"/>
+    </StackPanel>
+</Page>

components/Extensions/samples/Dispatcher/MouseDebounceSample.xaml.cs

@@ -0,0 +1,44 @@
+// 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.
+
+using CommunityToolkit.WinUI;
+#if WINAPPSDK
+using DispatcherQueue = Microsoft.UI.Dispatching.DispatcherQueue;
+using DispatcherQueueTimer = Microsoft.UI.Dispatching.DispatcherQueueTimer;
+#else
+using DispatcherQueue = Windows.System.DispatcherQueue;
+using DispatcherQueueTimer = Windows.System.DispatcherQueueTimer;
+#endif
+
+namespace ExtensionsExperiment.Samples.DispatcherQueueExtensions;
+
+[ToolkitSample(id: nameof(MouseDebounceSample), "DispatcherQueueTimer Debounce Mouse", description: "A sample for showing how to use the DispatcherQueueTimer Debounce extension to smooth mouse input.")]
+[ToolkitSampleNumericOption("Interval", 400, 300, 1000)]
+public sealed partial class MouseDebounceSample : Page
+{
+    public DispatcherQueueTimer _debounceTimer = DispatcherQueue.GetForCurrentThread().CreateTimer();
+
+    private int _count = 0;
+
+    public MouseDebounceSample()
+    {
+        InitializeComponent();
+    }
+
+    private void Button_Click(object sender, RoutedEventArgs e)
+    {
+        var interval = this.GeneratedPropertyMetadata?.FirstOrDefault(vm => vm.Name == "Interval")?.Value as double?;
+
+        if (interval != null)
+        {
+            _debounceTimer.Debounce(() =>
+                {
+                    ResultText.Text = $"You hit the button {++_count} times!";
+                },
+                interval: TimeSpan.FromMilliseconds(interval.Value),
+                // By being on the leading edge, we ignore inputs past the first for the duration of the interval
+                immediate: true);
+        }
+    }
+}

components/Extensions/samples/DispatcherQueueTimerExtensions.md

@@ -18,10 +18,14 @@ The `DispatcherQueueTimerExtensions` static class provides a collection of exten
 
 The `DispatcherQueueTimerExtensions` static class currently exposes a single extension method, `Debounce`. This is a standard technique used to rate-limit input from a user to not overload requests on an underlying service of query elsewhere.
 
-It can be used in a number of ways, but most simply like so:
+It can be used in a number of ways, but most simply like so as a keyboard limiter:
 
 > [!SAMPLE KeyboardDebounceSample]
 
+Or for preventing multiple inputs from occuring accidentally (e.g. ignoring a double/multi-click):
+
+> [!SAMPLE MouseDebounceSample]
+
 ## Examples
 
 You can find more examples in the [unit tests](https://github.com/CommunityToolkit/Windows/blob/rel/8.1.240916/components/Extensions/tests/DispatcherQueueTimerExtensionTests.cs).