Add EasyCarouselPanel

Author: ghost1372

README.md

@@ -135,6 +135,7 @@ Install-Package DevWinUI
 ## 🔥 DevWinUI.Controls 🔥
 ### ⚡ What’s Inside? ⚡
 
+- ✨ EasyCarouselPanel
 - ✨ Stars
 - ✨ BannerView
 - ✨ AudioWave
@@ -315,6 +316,9 @@ Install-Package DevWinUI.ContextMenu
 
 ## 🕰️ History 🕰️
 
+### EasyCarouselPanel
+![EasyCarouselPanel](https://raw.githubusercontent.com/ghost1372/DevWinUI-Resources/refs/heads/main/DevWinUI-Docs/EasyCarouselPanel.gif)
+
 ### Stars
 ![Stars](https://raw.githubusercontent.com/ghost1372/DevWinUI-Resources/refs/heads/main/DevWinUI-Docs/Stars.gif)
 

dev/DevWinUI.Controls/Controls/Win2DAndComposition/BannerView/BannerView.Properties.cs

@@ -1,4 +1,6 @@
-namespace DevWinUI;
+using static DevWinUI.EasyCarouselPanel;
+
+namespace DevWinUI;
 
 public partial class BannerView
 {
@@ -8,7 +10,7 @@ public bool IsPerspectiveEnable
         set { SetValue(IsPerspectiveEnableProperty, value); }
     }
     public static readonly DependencyProperty IsPerspectiveEnableProperty =
-        DependencyProperty.Register("IsPerspectiveEnable", typeof(bool), typeof(BannerView), new PropertyMetadata(false, (s, a) =>
+        DependencyProperty.Register(nameof(IsPerspectiveEnable), typeof(bool), typeof(BannerView), new PropertyMetadata(false, (s, a) =>
         {
             if (a.NewValue != a.OldValue)
             {
@@ -25,7 +27,7 @@ public bool IsScaleEnable
         set { SetValue(IsScaleEnableProperty, value); }
     }
     public static readonly DependencyProperty IsScaleEnableProperty =
-        DependencyProperty.Register("IsScaleEnable", typeof(bool), typeof(BannerView), new PropertyMetadata(false, (s, a) =>
+        DependencyProperty.Register(nameof(IsScaleEnable), typeof(bool), typeof(BannerView), new PropertyMetadata(false, (s, a) =>
         {
             if (a.NewValue != a.OldValue)
             {
@@ -43,7 +45,7 @@ public double ItemsSpacing
     }
 
     public static readonly DependencyProperty ItemsSpacingProperty =
-        DependencyProperty.Register("ItemsSpacing", typeof(double), typeof(BannerView), new PropertyMetadata(0d, (s, a) =>
+        DependencyProperty.Register(nameof(ItemsSpacing), typeof(double), typeof(BannerView), new PropertyMetadata(0d, (s, a) =>
         {
             if (a.NewValue != a.OldValue)
             {
@@ -89,4 +91,13 @@ private static void OnIntervalChanged(DependencyObject d, DependencyPropertyChan
             ctl.timer?.Interval = timeSpan;
         }
     }
+
+    public CarouselShiftingDirection ShiftingDirection
+    {
+        get { return (CarouselShiftingDirection)GetValue(ShiftingDirectionProperty); }
+        set { SetValue(ShiftingDirectionProperty, value); }
+    }
+
+    public static readonly DependencyProperty ShiftingDirectionProperty =
+        DependencyProperty.Register(nameof(ShiftingDirection), typeof(CarouselShiftingDirection), typeof(BannerView), new PropertyMetadata(CarouselShiftingDirection.Forward, null));
 }

dev/DevWinUI.Controls/Controls/Win2DAndComposition/BannerView/BannerView.cs

@@ -1,6 +1,4 @@
-using System.Reflection;
-using Microsoft.UI.Xaml.Controls;
-using Windows.Foundation.Metadata;
+using Windows.Foundation.Metadata;
 
 namespace DevWinUI;
 
@@ -29,7 +27,6 @@ public partial class BannerView : FlipView
 
     protected bool IsLoaded { get; private set; }
     private DispatcherTimer timer;
-    private bool isForward = true;
     public BannerView()
     {
         this.DefaultStyleKey = typeof(BannerView);
@@ -116,7 +113,7 @@ public void PlayShuffleForward()
         if (!AutoShuffle)
             return;
 
-        isForward = true;
+        ShiftingDirection = CarouselShiftingDirection.Forward;
         StartShuffleInternal();
     }
 
@@ -125,7 +122,7 @@ public void PlayShuffleBackward()
         if (!AutoShuffle)
             return;
 
-        isForward = false;
+        ShiftingDirection = CarouselShiftingDirection.Backward;
         StartShuffleInternal();
     }
 
@@ -135,10 +132,15 @@ private void StartShuffleInternal()
     }
     private void Timer_Tick(object sender, object e)
     {
-        if (isForward)
-            SelectedIndex++;
-        else
-            SelectedIndex--;
+        switch (ShiftingDirection)
+        {
+            case CarouselShiftingDirection.Forward:
+                SelectedIndex++;
+                break;
+            case CarouselShiftingDirection.Backward:
+                SelectedIndex--;
+                break;
+        }
     }
 
     private void ScrollingHost_ViewChanged(object sender, ScrollViewerViewChangedEventArgs e)

dev/DevWinUI.Controls/Controls/Win2DAndComposition/EasyCarouselPanel/CarouselShiftingDirection.cs

@@ -0,0 +1,7 @@
+namespace DevWinUI;
+
+public enum CarouselShiftingDirection
+{
+    Forward = 0,
+    Backward = 1
+}