Porting HeaderedContentControl

components/HeaderedContentControl/OpenSolution.bat

@@ -0,0 +1,3 @@
+@ECHO OFF
+
+powershell ..\..\tooling\ProjectHeads\GenerateSingleSampleHeads.ps1 -componentPath %CD% %*

components/HeaderedContentControl/samples/Dependencies.props

@@ -0,0 +1,31 @@
+<!--
+    WinUI 2 under UWP uses TargetFramework uap10.0.*
+    WinUI 3 under WinAppSdk uses TargetFramework net6.0-windows10.*
+    However, under Uno-powered platforms, both WinUI 2 and 3 can share the same TargetFramework.
+
+    MSBuild doesn't play nicely with this out of the box, so we've made it easy for you.
+
+    For .NET Standard packages, you can use the Nuget Package Manager in Visual Studio.
+    For UWP / WinAppSDK / Uno packages, place the package references here.
+-->
+<Project>
+    <!-- WinUI 2 / UWP -->
+    <ItemGroup Condition="'$(IsUwp)' == 'true'">
+        <!-- <PackageReference Include="Microsoft.Toolkit.Uwp.UI.Controls.Primitives" Version="7.1.2"/> -->
+    </ItemGroup>
+
+    <!-- WinUI 2 / Uno -->
+    <ItemGroup Condition="'$(IsUno)' == 'true' AND '$(WinUIMajorVersion)' == '2'">
+        <!-- <PackageReference Include="Uno.Microsoft.Toolkit.Uwp.UI.Controls.Primitives" Version="7.1.11"/> -->
+    </ItemGroup>
+
+    <!-- WinUI 3 / WinAppSdk -->
+    <ItemGroup Condition="'$(IsWinAppSdk)' == 'true'">
+        <!-- <PackageReference Include="CommunityToolkit.WinUI.UI.Controls.Primitives" Version="7.1.2"/> -->
+    </ItemGroup>
+
+    <!-- WinUI 3 / Uno -->
+    <ItemGroup Condition="'$(IsUno)' == 'true' AND '$(WinUIMajorVersion)' == '3'">
+        <!-- <PackageReference Include="Uno.CommunityToolkit.WinUI.UI.Controls.Primitives" Version="7.1.100-dev.15.g12261e2626"/> -->
+    </ItemGroup>
+</Project>

components/HeaderedContentControl/samples/HeaderedContentControl.Samples.csproj

@@ -0,0 +1,20 @@
+<Project Sdk="MSBuild.Sdk.Extras/3.0.23">
+  <PropertyGroup>
+    <ToolkitComponentName>HeaderedContentControl</ToolkitComponentName>
+  </PropertyGroup>
+
+  <!-- Sets this up as a toolkit component's sample project -->
+  <Import Project="$(ToolingDirectory)\ToolkitComponent.SampleProject.props" />
+  <ItemGroup>
+    <None Remove="Assets\BisonBadlandsChillin.jpg" />
+    <None Remove="Assets\Sunny.png" />
+  </ItemGroup>
+  <ItemGroup>
+    <Content Include="Assets\BisonBadlandsChillin.jpg">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </Content>
+    <Content Include="Assets\Sunny.png">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
+</Project>

components/HeaderedContentControl/samples/HeaderedContentControl.md

@@ -0,0 +1,70 @@
+---
+title: HeaderedContentControl
+author: skendrot
+description: The HeaderedContentControl allows content to be displayed with a specified header.
+keywords: HeaderedContentControl, Control, headered
+dev_langs:
+  - csharp
+category: Controls
+subcategory: Layout
+discussion-id: 0
+issue-id: 0
+---
+
+<# HeaderedContentControl
+
+The [HeaderedContentControl](/dotnet/api/microsoft.toolkit.uwp.ui.controls.headeredcontentcontrol) is a UI control that allows content to be displayed with a specified header. The `Header` property can be any object and you can use the `HeaderTemplate` to specify a custom look to the header. Content for the HeaderedContentControl will align to the top left. This is to maintain the same functionality as the ContentControl.
+
+> [!NOTE]
+> Setting the `Background`, `BorderBrush` and `BorderThickness` properties will not have any effect on the HeaderedContentControl. This is to maintain the same functionality as the ContentControl.
+
+> [!Sample HeaderedContentControlSample]
+
+## Syntax
+
+```xaml
+<Page ...
+     xmlns:controls="using:Microsoft.Toolkit.Uwp.UI.Controls"/>
+
+<controls:HeaderedContentControl>
+    <!-- Header content or HeaderTemplate content -->
+</controls:HeaderedContentControl>
+```
+
+## Properties
+
+| Property | Type | Gets or sets the data used for the header of each control |
+| -- | -- | -- |
+| Header | object | Gets or sets the data used for the header of each control |
+| HeaderTemplate | DataTemplate | Gets or sets the template used to display the content of the control's header |
+| Orientation | Orientation | Gets or sets the Orientation to use for layout of the header. If set to Vertical the Header will be above the content. If set to Horizontal the Header will be to the left of the content. |
+
+### Examples
+
+- The `Header` property can be set to a string, or any xaml elements. If binding the `Header` to an object that is not a string, use the `HeaderTemplate` to control how the content is rendered.
+
+    *Sample Code*
+
+    ```xaml
+    <controls:HeaderedContentControl Header="This is the header!"/>
+
+    <controls:HeaderedContentControl>
+        <controls:HeaderedContentControl.Header>
+            <Border Background="Gray">
+                <TextBlock Text="This is the header!" FontSize="16" />
+            </Border>
+        </controls:HeaderedContentControl.Header>
+    </controls:HeaderedContentControl>
+    ```
+
+- Used to control the look of the header. The default value for the `HeaderTemplate` will display the string representation of the `Header`. Set this property if you need to bind the `Header` to an object.
+
+    ```xaml
+    <controls:HeaderedContentControl Header="{Binding CustomObject}">
+        <controls:HeaderedContentControl.HeaderTemplate>
+            <DataTemplate>
+                <TextBlock Text="{Binding Title}" />
+            </DataTemplate>
+        </controls:HeaderedContentControl.HeaderTemplate>
+    </controls:HeaderedContentControl>
+    ```

components/HeaderedContentControl/samples/HeaderedContentControlSample.xaml

@@ -0,0 +1,65 @@
+<!--  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="HeaderedContentControlExperiment.Samples.HeaderedContentControlSample"
+      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:HeaderedContentControlExperiment.Samples"
+      xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+      mc:Ignorable="d">
+
+    <Grid>
+        <Grid.RowDefinitions>
+            <RowDefinition />
+            <RowDefinition />
+        </Grid.RowDefinitions>
+        <Grid.ColumnDefinitions>
+            <ColumnDefinition />
+            <ColumnDefinition />
+        </Grid.ColumnDefinitions>
+        <controls:HeaderedContentControl Grid.Row="0"
+                                         Grid.Column="0"
+                                         Margin="6"
+                                         HorizontalContentAlignment="Stretch"
+                                         VerticalContentAlignment="Stretch"
+                                         Header="Rectangle content">
+            <Rectangle MinHeight="160"
+                       Fill="{ThemeResource AccentFillColorDefaultBrush}" />
+        </controls:HeaderedContentControl>
+        <controls:HeaderedContentControl Grid.Row="0"
+                                         Grid.Column="1"
+                                         Margin="6"
+                                         Header="TextBlock content">
+            <TextBlock FontSize="12"
+                       Foreground="{ThemeResource TextFillColorSecondaryBrush}"
+                       Text="Some more text about this content"
+                       TextWrapping="Wrap" />
+        </controls:HeaderedContentControl>
+        <controls:HeaderedContentControl Grid.Row="1"
+                                         Grid.Column="0"
+                                         Margin="6"
+                                         Header="Image content">
+            <Image Source="ms-appx:///Assets/BisonBadlandsChillin.jpg" />
+        </controls:HeaderedContentControl>
+        <controls:HeaderedContentControl Grid.Row="1"
+                                         Grid.Column="1"
+                                         Margin="6"
+                                         Header="Lotso content">
+            <RelativePanel>
+                <Image x:Name="Icon"
+                       Width="50"
+                       Height="50"
+                       Source="ms-appx:///Assets/Sunny.png" />
+                <StackPanel x:Name="Temp"
+                            RelativePanel.RightOf="Icon">
+                    <TextBlock Text="65" />
+                </StackPanel>
+                <TextBlock FontSize="12"
+                           Foreground="{ThemeResource TextFillColorSecondaryBrush}"
+                           RelativePanel.AlignLeftWith="Temp"
+                           RelativePanel.Below="Temp"
+                           Text="Rainy" />
+            </RelativePanel>
+        </controls:HeaderedContentControl>
+    </Grid>
+</Page>

components/HeaderedContentControl/samples/HeaderedContentControlSample.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 CommunityToolkit.WinUI.Controls;
+
+namespace HeaderedContentControlExperiment.Samples;
+
+[ToolkitSample(id: nameof(HeaderedContentControlSample), "HeaderedContentControl", description: $"A sample for showing how to create and use a {nameof(HeaderedContentControl)} control.")]
+public sealed partial class HeaderedContentControlSample : Page
+{
+    public HeaderedContentControlSample()
+    {
+        this.InitializeComponent();
+    }
+}

components/HeaderedContentControl/src/AdditionalAssemblyInfo.cs

@@ -0,0 +1,13 @@
+// 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 System.Runtime.CompilerServices;
+
+// These `InternalsVisibleTo` calls are intended to make it easier for
+// for any internal code to be testable in all the different test projects
+// used with the Labs infrastructure.
+[assembly: InternalsVisibleTo("HeaderedContentControl.Tests.Uwp")]
+[assembly: InternalsVisibleTo("HeaderedContentControl.Tests.WinAppSdk")]
+[assembly: InternalsVisibleTo("CommunityToolkit.Tests.Uwp")]
+[assembly: InternalsVisibleTo("CommunityToolkit.Tests.WinAppSdk")]

components/HeaderedContentControl/src/CommunityToolkit.WinUI.Controls.HeaderedContentControl.csproj

@@ -0,0 +1,17 @@
+<Project Sdk="MSBuild.Sdk.Extras/3.0.23">
+  <PropertyGroup>
+    <ToolkitComponentName>HeaderedContentControl</ToolkitComponentName>
+    <Description>This package contains HeaderedContentControl.</Description>
+    <Version>8.0.0-beta.1</Version>
+
+    <!-- Rns suffix is required for namespaces shared across projects. See https://github.com/CommunityToolkit/Labs-Windows/issues/152 -->
+    <RootNamespace>CommunityToolkit.WinUI.Controls.HeaderedContentControlRns</RootNamespace>
+  </PropertyGroup>
+
+  <!-- Sets this up as a toolkit component's source project -->
+  <Import Project="$(ToolingDirectory)\ToolkitComponent.SourceProject.props" />
+
+   <PropertyGroup>
+    <PackageId>$(PackageIdPrefix).$(PackageIdVariant).Controls.$(ToolkitComponentName)</PackageId>
+  </PropertyGroup>
+</Project>

components/HeaderedContentControl/src/Dependencies.props

@@ -0,0 +1,31 @@
+<!--
+    WinUI 2 under UWP uses TargetFramework uap10.0.*
+    WinUI 3 under WinAppSdk uses TargetFramework net6.0-windows10.*
+    However, under Uno-powered platforms, both WinUI 2 and 3 can share the same TargetFramework.
+
+    MSBuild doesn't play nicely with this out of the box, so we've made it easy for you.
+
+    For .NET Standard packages, you can use the Nuget Package Manager in Visual Studio.
+    For UWP / WinAppSDK / Uno packages, place the package references here.
+-->
+<Project>
+    <!-- WinUI 2 / UWP -->
+    <ItemGroup Condition="'$(IsUwp)' == 'true'">
+        <!-- <PackageReference Include="Microsoft.Toolkit.Uwp.UI.Controls.Primitives" Version="7.1.2"/> -->
+    </ItemGroup>
+
+    <!-- WinUI 2 / Uno -->
+    <ItemGroup Condition="'$(IsUno)' == 'true' AND '$(WinUIMajorVersion)' == '2'">
+        <!-- <PackageReference Include="Uno.Microsoft.Toolkit.Uwp.UI.Controls.Primitives" Version="7.1.11"/> -->
+    </ItemGroup>
+
+    <!-- WinUI 3 / WinAppSdk -->
+    <ItemGroup Condition="'$(IsWinAppSdk)' == 'true'">
+        <!-- <PackageReference Include="CommunityToolkit.WinUI.UI.Controls.Primitives" Version="7.1.2"/> -->
+    </ItemGroup>
+
+    <!-- WinUI 3 / Uno -->
+    <ItemGroup Condition="'$(IsUno)' == 'true' AND '$(WinUIMajorVersion)' == '3'">
+        <!-- <PackageReference Include="Uno.CommunityToolkit.WinUI.UI.Controls.Primitives" Version="7.1.100-dev.15.g12261e2626"/> -->
+    </ItemGroup>
+</Project>