Renamed to WrapPanel2

Author: Avid29

components/StretchPanel/samples/StretchPanel.md

@@ -2,14 +2,14 @@
   <Import Project="$([MSBuild]::GetPathOfFileAbove(Directory.Build.props))" Condition="Exists('$([MSBuild]::GetPathOfFileAbove(Directory.Build.props))')" />
 
   <PropertyGroup>
-    <ToolkitComponentName>StretchPanel</ToolkitComponentName>
+    <ToolkitComponentName>WrapPanel2</ToolkitComponentName>
   </PropertyGroup>
 
   <!-- Sets this up as a toolkit component's sample project -->
   <Import Project="$(ToolingDirectory)\ToolkitComponent.SampleProject.props" />
   <ItemGroup>
-    <Compile Update="StretchPanelBasicSample.xaml.cs">
-      <DependentUpon>StretchPanelBasicSample.xaml</DependentUpon>
+    <Compile Update="WrapPanel2BasicSample.xaml.cs">
+      <DependentUpon>WrapPanel2BasicSample.xaml</DependentUpon>
     </Compile>
   </ItemGroup>
 </Project>

components/StretchPanel/OpenSolution.bat renamed to components/WrapPanel2/OpenSolution.bat

@@ -0,0 +1,54 @@
+---
+title: WrapPannel2
+author: Avid29
+description: A labs-component candidate for a new WrapPanel implementation.
+keywords: WrapPanel, Control, Layout
+dev_langs:
+  - csharp
+category: Layouts
+subcategory: Panel
+discussion-id: 762
+issue-id: 763
+icon: assets/icon.png
+---
+
+# WrapPanel2
+
+The WrapPanel2 is an experiment for a new WrapPanel API using GridLength definitions to define the item's desired sizings.
+
+When stretched along the main axis, the child elements with star-sized GridLength values will proportionally occupy the available space.
+
+When not stretched along the main axis, star-sized child elements will be the smallest size possible while maintaining proportional sizing relative to each other and ensuring that all child elements are fully visible.
+
+
+> [!Sample WrapPanel2BasicSample]
+
+## Properties
+
+### Fixed Row Length
+
+When `FixedRowLengths` is enabled, all rows/columns will to stretch to the size of the largest row/column in the panel. When this is not enabled, rows/columns will size to their content individually.
+
+### Forced Stretch Method
+
+The `ForcedStretchMethod` property allows you to specify how the panel should handle stretching in rows without star-sized definitions.
+
+#### None
+
+When set to `None`, this panel will not stretch rows/columns that do not have star-sized definitions. When the alignment is set to stretch, and even when fixed row lengths is enabled, the rows/columns without star-sized definitions will size to their content.
+
+#### First
+
+When set the `First`, this panel will stretch the first item in the row/column to occupy the remaining space when needed to comply with stretch alignment.
+
+#### Last
+
+When set to `Last`, this panel will stretch the last item in the row/column to occupy the remaining space when needed to comply with stretch alignment.
+
+#### Equal
+
+When set to `Equal`, this panel will stretch all items in the row/column to occupy the equal space throughout the row when needed to comply with stretch alignment.
+
+#### Proportional
+
+When set to `Proportional`, this panel will stretch all items in the row/column proportionally to their defined size to occupy the remaining space when needed to comply with stretch alignment.

components/StretchPanel/samples/Assets/icon.png renamed to components/WrapPanel2/samples/Assets/icon.png

@@ -1,10 +1,10 @@
 <!--  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.  -->
-<Page x:Class="StretchPanelExperiment.Samples.StretchPanelBasicSample"
+<Page x:Class="WrapPanel2Experiment.Samples.WrapPanel2BasicSample"
       xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
       xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
       xmlns:controls="using:CommunityToolkit.WinUI.Controls"
       xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
-      xmlns:local="using:StretchPanelExperiment.Samples"
+      xmlns:local="using:WrapPanel2Experiment.Samples"
       xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
       mc:Ignorable="d">
 
@@ -21,50 +21,50 @@
     </Page.Resources>
 
     <Grid Margin="16" MaxHeight="600">
-        <controls:StretchPanel Orientation="{x:Bind local:StretchPanelBasicSample.ConvertStringToOrientation(LayoutOrientation), Mode=OneWay}"
+        <controls:WrapPanel2 Orientation="{x:Bind local:WrapPanel2BasicSample.ConvertStringToOrientation(LayoutOrientation), Mode=OneWay}"
                                HorizontalSpacing="{x:Bind HorizontalSpacing, Mode=OneWay}"
                                VerticalSpacing="{x:Bind VerticalSpacing, Mode=OneWay}"
                                HorizontalAlignment="{x:Bind LayoutHorizontalAlignment, Mode=OneWay}"
                                VerticalAlignment="{x:Bind LayoutVerticalAlignment, Mode=OneWay}"
                                FixedRowLengths="{x:Bind FixedRowLengths, Mode=OneWay}"
-                               ForcedStretchMethod="{x:Bind local:StretchPanelBasicSample.ConvertStringToForcedStretchMethod(LayoutForcedStretchMethod), Mode=OneWay}"
-                               OverflowBehavior="{x:Bind local:StretchPanelBasicSample.ConvertStringToOverflowBehavior(LayoutOverflowBehavior), Mode=OneWay}">
-            <Border controls:StretchPanel.LayoutLength="2*" >
+                               ForcedStretchMethod="{x:Bind local:WrapPanel2BasicSample.ConvertStringToForcedStretchMethod(LayoutForcedStretchMethod), Mode=OneWay}"
+                               OverflowBehavior="{x:Bind local:WrapPanel2BasicSample.ConvertStringToOverflowBehavior(LayoutOverflowBehavior), Mode=OneWay}">
+            <Border controls:WrapPanel2.LayoutLength="2*" >
                 <TextBlock Text="2*" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="Auto" >
+            <Border controls:WrapPanel2.LayoutLength="Auto" >
                 <TextBlock Text="Auto" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="400" >
+            <Border controls:WrapPanel2.LayoutLength="400" >
                 <TextBlock Text="400px" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="1*" >
+            <Border controls:WrapPanel2.LayoutLength="1*" >
                 <TextBlock Text="1*" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="200" >
+            <Border controls:WrapPanel2.LayoutLength="200" >
                 <TextBlock Text="200px" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="300" >
+            <Border controls:WrapPanel2.LayoutLength="300" >
                 <TextBlock Text="300px" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="600">
+            <Border controls:WrapPanel2.LayoutLength="600">
                 <TextBlock Text="600px" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="2*">
+            <Border controls:WrapPanel2.LayoutLength="2*">
                 <TextBlock Text="2*" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="1.5*">
+            <Border controls:WrapPanel2.LayoutLength="1.5*">
                 <TextBlock Text="1.5*" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="Auto">
+            <Border controls:WrapPanel2.LayoutLength="Auto">
                 <TextBlock Text="Auto with longer text" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="400">
+            <Border controls:WrapPanel2.LayoutLength="400">
                 <TextBlock Text="400px" HorizontalAlignment="Center"/>
             </Border>
-            <Border controls:StretchPanel.LayoutLength="1*">
+            <Border controls:WrapPanel2.LayoutLength="1*">
                 <TextBlock Text="1*" HorizontalAlignment="Center"/>
             </Border>
-        </controls:StretchPanel>
+        </controls:WrapPanel2>
     </Grid>
 </Page>

components/StretchPanel/samples/Dependencies.props renamed to components/WrapPanel2/samples/Dependencies.props

@@ -4,7 +4,7 @@
 
 using CommunityToolkit.WinUI.Controls;
 
-namespace StretchPanelExperiment.Samples;
+namespace WrapPanel2Experiment.Samples;
 
 /// <summary>
 /// An example sample page of a custom control inheriting from Panel.
@@ -18,10 +18,10 @@ namespace StretchPanelExperiment.Samples;
 [ToolkitSampleMultiChoiceOption("LayoutForcedStretchMethod", "None", "First", "Last", "Equal", "Proportional", Title = "Forced Stretch Method")]
 [ToolkitSampleMultiChoiceOption("LayoutOverflowBehavior", "Wrap", "Drop", Title = "Overflow Behavior")]
 
-[ToolkitSample(id: nameof(StretchPanelBasicSample), "Custom control", description: $"A sample for showing how to create and use a {nameof(StretchPanel)} custom control.")]
-public sealed partial class StretchPanelBasicSample : Page
+[ToolkitSample(id: nameof(WrapPanel2BasicSample), "WrapPanel2 Basic Sample", description: $"A sample for showing how to use a {nameof(WrapPanel2)} panel.")]
+public sealed partial class WrapPanel2BasicSample : Page
 {
-    public StretchPanelBasicSample()
+    public WrapPanel2BasicSample()
     {
         this.InitializeComponent();
     }

components/StretchPanel/samples/StretchPanel.Samples.csproj renamed to components/WrapPanel2/samples/WrapPanel2.Samples.csproj

@@ -2,11 +2,11 @@
   <Import Project="$([MSBuild]::GetPathOfFileAbove(Directory.Build.props))" Condition="Exists('$([MSBuild]::GetPathOfFileAbove(Directory.Build.props))')" />
 
   <PropertyGroup>
-    <ToolkitComponentName>StretchPanel</ToolkitComponentName>
-    <Description>This package contains StretchPanel.</Description>
+    <ToolkitComponentName>WrapPanel2</ToolkitComponentName>
+    <Description>This package contains WrapPanel2.</Description>
 
     <!-- Rns suffix is required for namespaces shared across projects. See https://github.com/CommunityToolkit/Labs-Windows/issues/152 -->
-    <RootNamespace>CommunityToolkit.WinUI.Controls.StretchPanelRns</RootNamespace>
+    <RootNamespace>CommunityToolkit.WinUI.Controls.WrapPanel2Rns</RootNamespace>
   </PropertyGroup>
 
   <!-- Sets this up as a toolkit component's source project -->