Add AutoSelection property

Author: niels9001

components/SegmentedControl/samples/SegmentedControl.md

@@ -21,7 +21,7 @@ issue-id: 0
 
 # Segmented control
 
-The `Segmented` control is a control to be used for configuring a view or setting. It's based off `ListViewBase` and support single and multi-selection.
+The `Segmented` control is a control to be used for configuring a view or setting.
 
 
 ## The basics
@@ -30,6 +30,9 @@ The `Segmented` control is best used with 2-5 items and does not support overflo
 
 > [!Sample SegmentedControlBasicSample]
 
+## Selection
+`Segmented` supports single and multi-selection. When `SelectionMode` is set to `Single` the first item will be selected by default. This can be overriden by settings `AutoSelection` to `false`. 
+
 ## Other styles
 
 The `Segmented` control contains various additional styles, to match the look and feel of your application. The `PillSegmentedStyle` matches a modern `Pivot` and `NavigationView` style.

components/SegmentedControl/src/Segmented/Segmented.Properties.cs

@@ -0,0 +1,28 @@
+// 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 Windows.System;
+
+namespace CommunityToolkit.Labs.WinUI;
+
+public partial class Segmented : ListViewBase
+{
+    /// <summary>
+    /// The backing <see cref="DependencyProperty"/> for the <see cref="AutoSelection"/> property.
+    /// </summary>
+    public static readonly DependencyProperty AutoSelectionProperty = DependencyProperty.Register(
+        nameof(AutoSelection),
+        typeof(bool),
+        typeof(Segmented),
+        new PropertyMetadata(defaultValue: true));
+
+    /// <summary>
+    /// Gets or sets the icon.
+    /// </summary>
+    public bool AutoSelection
+    {
+        get => (bool)GetValue(AutoSelectionProperty);
+        set => SetValue(AutoSelectionProperty, value);
+    }
+}

components/SegmentedControl/src/Segmented/Segmented.cs

@@ -97,7 +97,7 @@ private void SetInitialSelection()
             }
 
             //  Otherwise, select the first item by default
-            else if (Items.Count >= 1 && SelectionMode == ListViewSelectionMode.Single)
+            else if (Items.Count >= 1 && SelectionMode == ListViewSelectionMode.Single && AutoSelection)
             {
                 SelectedItem = Items[0];
             }

components/SegmentedControl/src/SegmentedItem/SegmentedItem.Properties.cs

@@ -0,0 +1,26 @@
+// 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 SegmentedItem : ListViewItem
+{
+    /// <summary>
+    /// The backing <see cref="DependencyProperty"/> for the <see cref="Icon"/> property.
+    /// </summary>
+    public static readonly DependencyProperty IconProperty = DependencyProperty.Register(
+        nameof(Icon),
+        typeof(IconElement),
+        typeof(SegmentedItem),
+        new PropertyMetadata(defaultValue: null, (d, e) => ((SegmentedItem)d).OnIconPropertyChanged((IconElement)e.OldValue, (IconElement)e.NewValue)));
+
+    /// <summary>
+    /// Gets or sets the icon.
+    /// </summary>
+    public IconElement Icon
+    {
+        get => (IconElement)GetValue(IconProperty);
+        set => SetValue(IconProperty, value);
+    }
+}

components/SegmentedControl/src/SegmentedItem/SegmentedItem.cs

@@ -11,24 +11,6 @@ public partial class SegmentedItem : ListViewItem
     internal const string IconOnlyState = "IconOnly";
     internal const string ContentOnlyState = "ContentOnly";
 
-    /// <summary>
-    /// The backing <see cref="DependencyProperty"/> for the <see cref="Icon"/> property.
-    /// </summary>
-    public static readonly DependencyProperty IconProperty = DependencyProperty.Register(
-        nameof(Icon),
-        typeof(IconElement),
-        typeof(SegmentedItem),
-        new PropertyMetadata(defaultValue: null, (d, e) => ((SegmentedItem)d).OnIconPropertyChanged((IconElement)e.OldValue, (IconElement)e.NewValue)));
-
-    /// <summary>
-    /// Gets or sets the icon.
-    /// </summary>
-    public IconElement Icon
-    {
-        get => (IconElement)GetValue(IconProperty);
-        set => SetValue(IconProperty, value);
-    }
-
     public SegmentedItem()
     {
         this.DefaultStyleKey = typeof(SegmentedItem);