refactor: VisualStateManagerExtensions.OverrideStates -> States

doc/helpers/VisualStateManager-extensions.md

@@ -2,9 +2,9 @@
 Provides a way of manipulating the visual states of `Control` with attached property.
 
 ## Remarks
-`VisualStateManager.GoToState` is typically used with `Control` where you would set `<VisualStateManager.VisualStateGroups>` on the root element of the ControlTemplate. Because this class is implemented using the same method, it means that if you are setting `OverrideStatesProperty` on an element, the `VisualStateManager.VisualStateGroups` should not be set on the very same element, but its first child:
+`VisualStateManager.GoToState` is typically used with `Control` where you would set `<VisualStateManager.VisualStateGroups>` on the root element of the ControlTemplate. Because this class is implemented using the same method, it means that if you are setting `StatesProperty` on an element, the `VisualStateManager.VisualStateGroups` should not be set on the very same element, but its first child:
 ```xml
-<Page utu:VisualStateManagerExtensions.OverrideStates="{Binding OnboardingState}">
+<Page utu:VisualStateManagerExtensions.States="{Binding OnboardingState}">
     <!-- Wrong -->
     <VisualStateManager.VisualStateGroups>...
 
@@ -17,9 +17,9 @@ This "first child" is more common known as the template root within the context
 ## Properties
 Property|Type|Description
 -|-|-
-OverrideStates|string|Sets the visual states of the control.\*
+States|string|Sets the visual states of the control.\*
 
-OverrideStates\*: The accepted value can be a space, comma or semi-colon separated list of visual state names. eg:
+States\*: The accepted value can be a space, comma or semi-colon separated list of visual state names. eg:
   - "LoggedIn": just a single state
   - "LoggedIn, OnMeteredNetwork": two concurrent states from different visual state groups
   - "Pressed, Selected, PressedSelected": with a combined state
@@ -29,7 +29,7 @@ OverrideStates\*: The accepted value can be a space, comma or semi-colon separat
 ```xml
 <Page ...
       xmlns:utu="using:Uno.Toolkit.UI"
-      utu:VisualStateManagerExtensions.OverrideStates="{Binding PageState}">
+      utu:VisualStateManagerExtensions.States="{Binding PageState}">
     <Grid ColumnDefinitions="Auto,*" RowDefinitions="*,*,*">
 
         <VisualStateManager.VisualStateGroups>

samples/Uno.Toolkit.Samples/Uno.Toolkit.Samples.Shared/Content/Controls/VisualStateManagerExtensionsSamplePage.xaml

@@ -12,7 +12,7 @@
 		<sample:SamplePageLayout.DesignAgnosticTemplate>
 			<DataTemplate>
 				<UserControl DataContext="{Binding Data}"
-							 utu:VisualStateManagerExtensions.OverrideStates="{Binding PageState}"
+							 utu:VisualStateManagerExtensions.States="{Binding PageState}"
 							 Margin="0,16,0,0">
 					<Grid>
 						<Grid.ColumnDefinitions>

src/Uno.Toolkit.UI/Behaviors/VisualStateManagerExtensions.cs

@@ -26,34 +26,34 @@ namespace Uno.Toolkit.UI;
 /// <remarks>
 /// <seealso cref="VisualStateManager.GoToState"/> is typically used with <see cref="Control"/>
 /// where you would set <see cref="VisualStateManager.VisualStateGroupsProperty"/> on the root element of the ControlTemplate.
-/// Because this class directly calls that method, it means that if you are setting <see cref="OverrideStatesProperty"/> on an element,
+/// Because this class directly calls that method, it means that if you are setting <see cref="StatesProperty"/> on an element,
 /// the <see cref="VisualStateManager.VisualStateGroupsProperty"/> should not be set on the very same element, but its first child.
 /// </remarks>
 public static class VisualStateManagerExtensions
 {
 	private static readonly ILogger Logger = typeof(VisualStateManagerExtensions).Log();
 
-	#region DependencyProperty: OverrideStates
+	#region DependencyProperty: States
 
 	/// <summary>
-	/// Identifies the OverrideStates dependency property.
+	/// Identifies the States dependency property.
 	/// </summary>
-	public static DependencyProperty OverrideStatesProperty { get; } = DependencyProperty.RegisterAttached(
-		"OverrideStates",
+	public static DependencyProperty StatesProperty { get; } = DependencyProperty.RegisterAttached(
+		"States",
 		typeof(string),
 		typeof(VisualStateManagerExtensions),
-		new PropertyMetadata(default(string), OnOverrideStatesChanged));
+		new PropertyMetadata(default(string), OnStatesChanged));
 
 	/// <summary>
 	/// Sets the visual states of the control.
 	/// </summary>
 	/// <param name="obj"></param>
 	/// <param name="value">A space, comma or semi-colon separated list of visual state names</param>
-	public static void SetOverrideStates(Control obj, string value) => obj.SetValue(OverrideStatesProperty, value);
+	public static void SetStates(Control obj, string value) => obj.SetValue(StatesProperty, value);
 
 	#endregion
 
-	private static void OnOverrideStatesChanged(DependencyObject sender, DependencyPropertyChangedEventArgs e)
+	private static void OnStatesChanged(DependencyObject sender, DependencyPropertyChangedEventArgs e)
 	{
 		if (sender is Control control && e.NewValue is string { Length: >0 } value)
 		{