diff --git a/components/Segmented/src/ReadMe.md b/components/Segmented/src/ReadMe.md
index 326aad66..1839633f 100644
--- a/components/Segmented/src/ReadMe.md
+++ b/components/Segmented/src/ReadMe.md
@@ -9,6 +9,10 @@ This package contains the following controls in the `CommunityToolkit.WinUI.Cont
- Segmented
+On Windows, `Segmented` exposes the UI Automation Selection pattern and its items
+expose the SelectionItem pattern through native list automation peers. Set
+`AutomationProperties.Name` on the control to provide an accessible name.
+
## Which Package is for me?
If you're developing with _UWP/WinUI 2 or Uno.UI_ you should be using the `CommunityToolkit.Uwp.Controls.Segmented` package.
diff --git a/components/Segmented/src/Segmented/Segmented.cs b/components/Segmented/src/Segmented/Segmented.cs
index 6fbc6c30..71c71b8c 100644
--- a/components/Segmented/src/Segmented/Segmented.cs
+++ b/components/Segmented/src/Segmented/Segmented.cs
@@ -2,6 +2,7 @@
// 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.Automation.Peers;
using Windows.System;
namespace CommunityToolkit.WinUI.Controls;
@@ -24,6 +25,9 @@ public Segmented()
RegisterPropertyChangedCallback(SelectedIndexProperty, OnSelectedIndexChanged);
}
+ ///
+ protected override AutomationPeer OnCreateAutomationPeer() => new SegmentedAutomationPeer(this);
+
///
protected override DependencyObject GetContainerForItemOverride() => new SegmentedItem();
diff --git a/components/Segmented/src/Segmented/SegmentedAutomationPeer.cs b/components/Segmented/src/Segmented/SegmentedAutomationPeer.cs
new file mode 100644
index 00000000..22389c7f
--- /dev/null
+++ b/components/Segmented/src/Segmented/SegmentedAutomationPeer.cs
@@ -0,0 +1,29 @@
+// 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.Controls;
+
+namespace CommunityToolkit.WinUI.Automation.Peers;
+
+///
+/// Defines an automation peer for the control.
+///
+public partial class SegmentedAutomationPeer : ListViewBaseAutomationPeer
+{
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The associated with this automation peer.
+ public SegmentedAutomationPeer(Segmented owner)
+ : base(owner)
+ {
+ }
+
+ ///
+ protected override string GetClassNameCore() => nameof(Segmented);
+
+ ///
+ protected override ItemAutomationPeer OnCreateItemAutomationPeer(object item)
+ => new ListViewItemDataAutomationPeer(item, this);
+}
diff --git a/components/Segmented/tests/Segmented.Tests.projitems b/components/Segmented/tests/Segmented.Tests.projitems
index 25f1b261..20cb0315 100644
--- a/components/Segmented/tests/Segmented.Tests.projitems
+++ b/components/Segmented/tests/Segmented.Tests.projitems
@@ -9,6 +9,7 @@
SegmentedTests
+
ExampleSegmentedTestPage.xaml
diff --git a/components/Segmented/tests/Test_Segmented_AutomationPeer.cs b/components/Segmented/tests/Test_Segmented_AutomationPeer.cs
new file mode 100644
index 00000000..8d8e998a
--- /dev/null
+++ b/components/Segmented/tests/Test_Segmented_AutomationPeer.cs
@@ -0,0 +1,213 @@
+// 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.
+
+#if !HAS_UNO
+using CommunityToolkit.Tests;
+using CommunityToolkit.Tooling.TestGen;
+using CommunityToolkit.WinUI.Controls;
+using System.Runtime.InteropServices;
+
+#if WINAPPSDK
+using Microsoft.UI.Xaml.Automation.Provider;
+#else
+using Windows.UI.Xaml.Automation.Provider;
+#endif
+
+namespace SegmentedTests;
+
+[TestClass]
+[TestCategory("Test_Segmented_AutomationPeer")]
+public partial class Test_Segmented_AutomationPeer : VisualUITestBase
+{
+ [UIThreadTestMethod]
+ public Task StringItemsExposeSelection() => VerifySelectionAsync(false);
+
+ [UIThreadTestMethod]
+ public Task ExplicitContainersExposeSelection() => VerifySelectionAsync(true);
+
+ [UIThreadTestMethod]
+ public Task StringItemSelectionRespectsIsEnabled() => VerifySelectAsync(false);
+
+ [UIThreadTestMethod]
+ public Task ExplicitContainerSelectionRespectsIsEnabled() => VerifySelectAsync(true);
+
+ [UIThreadTestMethod]
+ public Task StringItemPeersTrackCollectionChanges() => VerifyCollectionChangesAsync(false);
+
+ [UIThreadTestMethod]
+ public Task ExplicitContainerPeersTrackCollectionChanges() => VerifyCollectionChangesAsync(true);
+
+ private async Task VerifySelectionAsync(bool explicitContainers)
+ {
+ var (control, items) = CreateControl(explicitContainers);
+ await LoadTestContentAsync(control);
+
+ var peer = GetPeer(control);
+ Assert.AreEqual("View mode", peer.GetName());
+ Assert.AreEqual(nameof(Segmented), peer.GetClassName());
+ Assert.AreEqual(AutomationControlType.List, peer.GetAutomationControlType());
+
+ var selection = GetSelectionProvider(peer);
+ Assert.IsFalse(selection.CanSelectMultiple);
+
+ var itemProviders = GetItemProviders(peer, "List", "Grid", "Details");
+ for (var selectedIndex = 0; selectedIndex <= 1; selectedIndex++)
+ {
+ control.SelectedIndex = selectedIndex;
+
+ Assert.AreSame(items[selectedIndex], control.SelectedItem);
+ AssertSelection(selection, itemProviders, selectedIndex, selectedIndex == 0 ? "List" : "Grid");
+ }
+ }
+
+ private async Task VerifySelectAsync(bool explicitContainers)
+ {
+ var (control, items) = CreateControl(explicitContainers);
+ await LoadTestContentAsync(control);
+ control.SelectedIndex = 0;
+
+ var peer = GetPeer(control);
+ var selection = GetSelectionProvider(peer);
+ var itemProviders = GetItemProviders(peer, "List", "Grid", "Details");
+
+ itemProviders[1].Select();
+
+ Assert.AreEqual(1, control.SelectedIndex);
+ Assert.AreSame(items[1], control.SelectedItem);
+ AssertSelection(selection, itemProviders, 1, "Grid");
+
+ control.IsEnabled = false;
+ var exception = Assert.ThrowsException(() => itemProviders[0].Select());
+ Assert.AreEqual(unchecked((int)0x80040200), exception.HResult, "Expected UIA_E_ELEMENTNOTENABLED.");
+
+ Assert.AreEqual(1, control.SelectedIndex);
+ Assert.AreSame(items[1], control.SelectedItem);
+
+ // Native item peers also reject IsSelected while disabled.
+ control.IsEnabled = true;
+ AssertSelection(selection, itemProviders, 1, "Grid");
+ }
+
+ private async Task VerifyCollectionChangesAsync(bool explicitContainers)
+ {
+ var (control, items) = CreateControl(explicitContainers);
+ await LoadTestContentAsync(control);
+ control.SelectedIndex = 1;
+
+ var peer = GetPeer(control);
+ var selection = GetSelectionProvider(peer);
+ var originalProviders = GetItemProviders(peer, "List", "Grid", "Details");
+ var selectedItem = items[1];
+
+ // Native Move notifications can reset selection; remove/insert preserves the selected logical item.
+ var movedItem = items[2];
+ items.RemoveAt(2);
+ items.Insert(0, movedItem);
+ await CompositionTargetHelper.ExecuteAfterCompositionRenderingAsync(() => { });
+
+ Assert.AreEqual(2, control.SelectedIndex);
+ Assert.AreSame(selectedItem, control.SelectedItem);
+ AssertSelection(selection, GetItemProviders(peer, "Details", "List", "Grid"), 2, "Grid");
+ AssertSelection(selection, originalProviders, 1, "Grid");
+
+ items.Remove(selectedItem);
+ await CompositionTargetHelper.ExecuteAfterCompositionRenderingAsync(() => { });
+
+ // A retained peer must still refer to List, not the item now at its old index.
+ originalProviders[0].Select();
+
+ Assert.AreEqual(1, control.SelectedIndex);
+ Assert.AreSame(items[1], control.SelectedItem);
+ AssertSelection(selection, GetItemProviders(peer, "Details", "List"), 1, "List");
+ AssertSelection(selection, new[] { originalProviders[0], originalProviders[2] }, 0, "List");
+ }
+
+ private static (Segmented Control, ObservableCollection