如何创建可容纳UIElement子元素的WPF容器用户控件？

嘿，我来帮你搞定这个需求！要让你的DisplayContainer能像Grid、Border这类标准WPF容器一样，直接嵌套任意UIElement作为子元素，核心就是给你的UserControl定义一个内容属性，让XAML解析器自动识别嵌套的元素。下面一步步来实现：

1. 调整UserControl的XAML结构 #

首先在你的DisplayContainer.xaml里，需要预留一个专门承载子元素的区域，这里用ContentControl会更灵活。同时保留你已经做的Title绑定逻辑：

<UserControl x:Class="YourNamespace.DisplayContainer"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
             mc:Ignorable="d">
    <Grid x:Name="Grid_Main">
        <Border x:Name="Border_Main" BorderThickness="2" Margin="10" CornerRadius="5" Padding="10">
            <StackPanel>
                <!-- 标题展示区域 -->
                <TextBlock Text="{Binding Title, RelativeSource={RelativeSource AncestorType=UserControl}}" 
                           FontSize="16" FontWeight="Bold" Margin="0 0 0 8"/>
                <!-- 子元素的承载容器 -->
                <ContentControl x:Name="ContentHost" />
            </StackPanel>
        </Border>
    </Grid>
</UserControl>

2. 在代码后台定义内容属性 #

接下来要在DisplayContainer.xaml.cs里，通过[ContentProperty]特性告诉WPF：哪个属性是这个容器的「内容属性」，这样XAML里嵌套的元素会自动赋值给它。同时我们需要给子内容定义一个依赖属性，确保它能支持绑定等WPF特性：

using System.Windows;
using System.Windows.Controls;

namespace YourNamespace
{
    // 标记ChildContent为这个控件的内容属性
    [ContentProperty(nameof(ChildContent))]
    public partial class DisplayContainer : UserControl
    {
        // 保留你已经实现的Title依赖属性
        public static readonly DependencyProperty TitleProperty =
            DependencyProperty.Register(nameof(Title), typeof(string), typeof(DisplayContainer), new PropertyMetadata(string.Empty));

        public string Title
        {
            get => (string)GetValue(TitleProperty);
            set => SetValue(TitleProperty, value);
        }

        // 新增子内容的依赖属性
        public static readonly DependencyProperty ChildContentProperty =
            DependencyProperty.Register(nameof(ChildContent), typeof(object), typeof(DisplayContainer), new PropertyMetadata(null));

        public object ChildContent
        {
            get => GetValue(ChildContentProperty);
            set => SetValue(ChildContentProperty, value);
        }

        public DisplayContainer()
        {
            InitializeComponent();
            // 把ContentHost的Content和ChildContent属性绑定起来
            ContentHost.SetBinding(ContentControl.ContentProperty, new Binding(nameof(ChildContent)) { Source = this });
        }
    }
}

3. 按你期望的方式使用控件 #

现在你就可以完全按照你想要的方式来使用DisplayContainer了，不管是单个TextBlock，还是复杂的布局容器都能嵌套：

<general:DisplayContainer Title="Hello">
    <TextBlock x:Name="AnyUIElement" Text="这是一个子元素示例"/>
    <!-- 也可以嵌套更复杂的内容，比如：
    <StackPanel>
        <Button Content="点击测试"/>
        <TextBox Text="输入一些内容"/>
    </StackPanel> -->
</general:DisplayContainer>

额外小提示 #

• 如果你希望这个容器只能接受UIElement类型的子元素（避免不小心放了非UI对象），可以把ChildContent的类型从object改成UIElement，这样XAML编辑器会自动提示错误。
• 如果未来需要支持多个子元素（类似StackPanel那样），可以把ContentControl换成ItemsControl，然后把内容属性指定为Items就可以了，不过从你的需求来看，单个子元素的场景用ContentControl完全足够。

内容的提问来源于stack exchange，提问作者Aaginor