Add IsAutoScrollEnabled in HeaderCarousel

ghost1372 · ghost1372 · commit e2eff7690365 · 2025-07-05T16:14:40.000+03:30
diff --git a/dev/DevWinUI.Controls/Controls/HeaderCarousel/HeaderCarousel.Properties.cs b/dev/DevWinUI.Controls/Controls/HeaderCarousel/HeaderCarousel.Properties.cs
@@ -1,6 +1,24 @@
 ﻿namespace DevWinUI;
 public partial class HeaderCarousel
 {
+    public bool IsAutoScrollEnabled
+    {
+        get { return (bool)GetValue(IsAutoScrollEnabledProperty); }
+        set { SetValue(IsAutoScrollEnabledProperty, value); }
+    }
+
+    public static readonly DependencyProperty IsAutoScrollEnabledProperty =
+        DependencyProperty.Register(nameof(IsAutoScrollEnabled), typeof(bool), typeof(HeaderCarousel), new PropertyMetadata(true, OnIsAutoScrollEnabledChanged));
+
+    private static void OnIsAutoScrollEnabledChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
+    {
+        var ctl = (HeaderCarousel)d;
+        if (ctl != null)
+        {
+            ctl.ApplyAutoScroll();
+        }
+    }
+
     public Stretch ImageStretch
     {
         get { return (Stretch)GetValue(ImageStretchProperty); }
diff --git a/dev/DevWinUI.Controls/Controls/HeaderCarousel/HeaderCarousel.cs b/dev/DevWinUI.Controls/Controls/HeaderCarousel/HeaderCarousel.cs
@@ -65,12 +65,10 @@ private void HeaderCarousel_Unloaded(object sender, RoutedEventArgs e)
 
     private void HeaderCarousel_Loaded(object sender, RoutedEventArgs e)
     {
-        ResetAndShuffle();
-        SelectNextTile();
-
         selectionTimer.Tick += SelectionTimer_Tick;
         deselectionTimer.Tick += DeselectionTimer_Tick;
-        selectionTimer?.Start();
+
+        ApplyAutoScroll();
     }
     protected override void OnItemsChanged(object e)
     {
@@ -276,4 +274,18 @@ private void Tile_LostFocus(object sender, RoutedEventArgs e)
         ((HeaderCarouselItem)sender).IsSelected = false;
         selectionTimer.Start();
     }
+
+    private void ApplyAutoScroll()
+    {
+        if (IsAutoScrollEnabled)
+        {
+            ResetAndShuffle();
+            SelectNextTile();
+        }
+        else
+        {
+            selectionTimer?.Stop();
+            deselectionTimer?.Stop();
+        }
+    }
 }
diff --git a/dev/DevWinUI.Gallery/Views/Pages/Features/HeaderCarouselPage.xaml b/dev/DevWinUI.Gallery/Views/Pages/Features/HeaderCarouselPage.xaml
@@ -17,6 +17,9 @@
                                   XamlSource="Features/HeaderCarouselPage_xaml.txt">
                 <local:ControlExample.Pane>
                     <StackPanel Spacing="10">
+                        <ToggleSwitch x:Name="TGIsAutoScrollEnabled"
+                                      Header="IsAutoScrollEnabled"
+                                      IsOn="True" />
                         <ToggleSwitch x:Name="TGIsBlurEnabled"
                                       Header="IsBlurEnabled"
                                       IsOn="True" />
@@ -47,6 +50,7 @@
                     </StackPanel>
                 </local:ControlExample.Pane>
                 <dev:HeaderCarousel BlurAmount="{x:Bind SliderAmount.Value, Mode=OneWay}"
+                                    IsAutoScrollEnabled="{x:Bind TGIsAutoScrollEnabled.IsOn, Mode=OneWay}"
                                     IsBlurEnabled="{x:Bind TGIsBlurEnabled.IsOn, Mode=OneWay}"
                                     ItemClick="HeaderCarousel_ItemClick">
                     <dev:HeaderCarousel.Header>
