Add AutoSelectBehavior

Author: jbrianceau

Microsoft.Toolkit.Uwp.SampleApp/Microsoft.Toolkit.Uwp.SampleApp.csproj

@@ -488,6 +488,9 @@
     <Compile Include="SamplePages\AutoFocusBehavior\AutoFocusBehaviorPage.xaml.cs">
       <DependentUpon>AutoFocusBehaviorPage.xaml</DependentUpon>
     </Compile>
+    <Compile Include="SamplePages\AutoSelectBehavior\AutoSelectBehaviorPage.xaml.cs">
+      <DependentUpon>AutoSelectBehaviorPage.xaml</DependentUpon>
+    </Compile>
     <Compile Include="SamplePages\CanvasPathGeometry\GeometryStreamReader.cs" />
     <Compile Include="SamplePages\ColorPicker\ColorPickerButtonPage.xaml.cs">
       <DependentUpon>ColorPickerButtonPage.xaml</DependentUpon>
@@ -614,6 +617,7 @@
     <Content Include="SamplePages\Animations\Behaviors\RotateBehaviorXaml.bind" />
     <Content Include="SamplePages\Animations\Effects\EffectAnimations.bind" />
     <Content Include="SamplePages\VisualEffectFactory\VisualEffectFactory.bind" />
+    <Content Include="SamplePages\AutoSelectBehavior\AutoSelectBehaviorXaml.bind" />
   </ItemGroup>
   <ItemGroup>
     <Compile Include="App.xaml.cs">
@@ -951,6 +955,10 @@
       <SubType>Designer</SubType>
       <Generator>MSBuild:Compile</Generator>
     </Page>
+    <Page Include="SamplePages\AutoSelectBehavior\AutoSelectBehaviorPage.xaml">
+      <Generator>MSBuild:Compile</Generator>
+      <SubType>Designer</SubType>
+    </Page>
     <Page Include="SamplePages\ColorPicker\ColorPickerButtonPage.xaml">
       <Generator>MSBuild:Compile</Generator>
       <SubType>Designer</SubType>

Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AutoSelectBehavior/AutoSelectBehaviorPage.xaml

@@ -0,0 +1,21 @@
+<Page x:Class="Microsoft.Toolkit.Uwp.SampleApp.SamplePages.AutoSelectBehaviorPage"
+      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+      xmlns:behaviors="using:Microsoft.Toolkit.Uwp.UI.Behaviors"
+      xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+      xmlns:interactivity="using:Microsoft.Xaml.Interactivity"
+      xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+      mc:Ignorable="d">
+
+    <Grid>
+        <StackPanel HorizontalAlignment="Center"
+                    VerticalAlignment="Center">
+            <TextBox Text="My content is not selected when loaded" />
+            <TextBox Text="My content is selected when loaded">
+                <interactivity:Interaction.Behaviors>
+                    <behaviors:AutoSelectBehavior />
+                </interactivity:Interaction.Behaviors>
+            </TextBox>
+        </StackPanel>
+    </Grid>
+</Page>

Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AutoSelectBehavior/AutoSelectBehaviorPage.xaml.cs

@@ -0,0 +1,16 @@
+// 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.UI.Xaml.Controls;
+
+namespace Microsoft.Toolkit.Uwp.SampleApp.SamplePages
+{
+    /// <summary>
+    /// A page that shows how to use the AutoSelectBehaviorPage
+    /// </summary>
+    public sealed partial class AutoSelectBehaviorPage : Page
+    {
+        public AutoSelectBehaviorPage() => InitializeComponent();
+    }
+}

Microsoft.Toolkit.Uwp.SampleApp/SamplePages/AutoSelectBehavior/AutoSelectBehaviorXaml.bind

@@ -0,0 +1,20 @@
+<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+      xmlns:behaviors="using:Microsoft.Toolkit.Uwp.UI.Behaviors"
+      xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+      xmlns:interactivity="using:Microsoft.Xaml.Interactivity"
+      xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+      mc:Ignorable="d">
+
+  <Grid>
+    <StackPanel HorizontalAlignment="Center"
+                VerticalAlignment="Center">
+      <TextBox Text="My content is not selected when loaded" />
+      <TextBox Text="My content is selected when loaded">
+        <interactivity:Interaction.Behaviors>
+          <behaviors:AutoSelectBehavior />
+        </interactivity:Interaction.Behaviors>
+      </TextBox>
+    </StackPanel>
+  </Grid>
+</Page>

Microsoft.Toolkit.Uwp.SampleApp/SamplePages/samples.json

@@ -857,6 +857,15 @@
         "Icon": "/Assets/Helpers.png",
         "DocumentationUrl": "https://raw.githubusercontent.com/MicrosoftDocs/WindowsCommunityToolkitDocs/master/docs/behaviors/FocusBehavior.md"
       },
+      {
+        "Name": "AutoSelectBehavior",
+        "Type": "AutoSelectBehaviorPage",
+        "Subcategory": "Systems",
+        "About": "Behavior to automatically select the entire content of a TextBox control when it loads",
+        "CodeUrl": "https://github.com/windows-toolkit/WindowsCommunityToolkit/tree/master/Microsoft.Toolkit.Uwp.UI/Behaviors/",
+        "XamlCodeFile": "AutoSelectBehaviorXaml.bind",
+        "Icon": "/Assets/Helpers.png"
+      },
       {
         "Name": "Win2d Path Mini Language Parser",
         "Type": "CanvasPathGeometryPage",

Microsoft.Toolkit.Uwp.UI.Behaviors/Select/AutoSelectBehavior.cs

@@ -0,0 +1,17 @@
+// 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.UI.Xaml.Controls;
+
+namespace Microsoft.Toolkit.Uwp.UI.Behaviors
+{
+    /// <summary>
+    /// This behavior automatically selects the entire content of the associated <see cref="TextBox"/> when it is loaded.
+    /// </summary>
+    public sealed class AutoSelectBehavior : BehaviorBase<TextBox>
+    {
+        /// <inheritdoc/>
+        protected override void OnAssociatedObjectLoaded() => AssociatedObject.SelectAll();
+    }
+}