将子项添加到 UserControl

Question

我的任务

创建一个 UserControl ，它应该能够包含 WPF 中可用的任何可视子项，这些子项显示在作为 UserControl 的子项的容器中。

我的问题

我无法让子项在我的容器中正确显示，我尝试了几种方法，但没有找到在设计器中有效的方法。我还尝试使用 ContentControl 但没有显示任何内容。

我的方法

首先我找到这个链接我尝试了一些变化。我设法在正确的容器中显示内容，但它在设计器中不起作用，因为内容属性设置为私有，并且设计器想要覆盖它。将所有内容都放在 XAML 中是可行的，但在与设计师合作时这并不好。这是可能最喜欢的方式。

之后，我尝试通过将其 Content 属性绑定到 UIElementCollection 类型的可绑定属性来使用 ContentControl。这种方法不会在设计器中引发任何错误，但我必须承认我在容器中从未看到任何控件（例如 Button ）。它仍然是空的，但添加了孩子。

结论

经过几个小时的寻找简单快捷的解决方案后，我决定在这里寻求解决方案。我有点失望。如果 Microsoft 能够在 MSDN 中提供一个示例，那将会非常有帮助。

我确信一定有一种简单的方法来存档它。

当前情况

感谢 Andrei Gavrila 和 jberger 我归档创建了一个显示内容的节点（请参阅下面的代码），但仍然存在两个问题： - 没有设计师支持 - 边框（请参阅 xaml ）不会在设计器中显示，并且在应用程序运行时不会显示，甚至没有边距

public class NodeContent : ContentControl
{
    static NodeContent()
    {
        DefaultStyleKeyProperty.OverrideMetadata(typeof(NodeContent), new FrameworkPropertyMetadata(typeof(NodeContent)));
    }
}

public partial class Node : UserControl, INotifyPropertyChanged
{
    UIElementCollection _Elements;

    public event PropertyChangedEventHandler PropertyChanged;

    public UIElementCollection NodeContent
    {
        get { return _Elements; }
        set
        {
            _Elements = value;
            OnPropertyChanged("NodeContent");
        }
    }

    public Node()
    {
        InitializeComponent();
        NodeContent = new UIElementCollection(NodeContentContainer, this);
    }



    protected void OnPropertyChanged(string name)
    {
        PropertyChangedEventHandler handler = PropertyChanged;
        if (handler != null)
        {
            handler(this, new PropertyChangedEventArgs(name));
        }
    }
}

Node-Xaml：

<UserControl x:Class="Pipedream.Nodes.Node"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" 
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008" 
             mc:Ignorable="d" 
             d:DesignHeight="216" d:DesignWidth="174" Background="Transparent" Name="NodeControl" xmlns:my="clr-namespace:Pipedream.Nodes">

    <Border BorderThickness="1" CornerRadius="20" BorderBrush="Black" Background="White">
        <Grid>
            <my:NodeContent x:Name="NodeContentContainer" Margin="20" Content="{Binding Source=NodeControl, Path=NodeContent}" />
        </Grid>
    </Border>
</UserControl>

Generic-Xaml：

<ResourceDictionary
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="clr-namespace:Pipedream.Nodes">


    <Style TargetType="{x:Type local:NodeContent}">
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="{x:Type local:Node}">
                    <Border Background="{TemplateBinding Background}"
                            BorderBrush="{TemplateBinding BorderBrush}"
                            BorderThickness="{TemplateBinding BorderThickness}">
                        <ContentPresenter />
                    </Border>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>
</ResourceDictionary>

Answer 1

通常，您无法绑定 UIElementCollection 类型的依赖属性。尝试这样的事情：

MultiChildDemo.xaml

这里没什么可看的。 StackPanel 将保存我们的子元素。显然你可以做得更多。

代码：

<UserControl x:Class="Demo.MultiChildDemo"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
             xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
             xmlns:demo="clr-namespace:Demo"
             mc:Ignorable="d"
             d:DesignHeight="300" d:DesignWidth="300">
    <StackPanel x:Name="PART_Host" />
</UserControl>

MultiChildDemo.xaml.cs

需要注意的重要事项：

• ContentPropertyAttribute 特性设置将由该类型的父元素所包含的任何元素设置的属性。因此， 中的任何元素都将添加到 Children 属性中。
• 我们正在扩展UserControl。这并不需要完全自定义的控件。
• 在 WPF 中，使用 DependencyProperty.Register() 和变体创建属性是一种很好的做法。您会注意到 Children 属性没有支持变量：DependencyProperty 负责为我们存储数据。如果我们不创建只读属性，这将允许使用绑定和其他很酷的 WPF 功能。因此，养成使用依赖属性的习惯非常重要，而不是像您在 Internet 上的示例中经常看到的普通属性。
• 这是一个相对简单的依赖属性示例。我们所做的就是复制对子级依赖属性的引用，从而将调用转发到 UIElementCollection.Add。还有更复杂的示例，尤其是在 MSDN 上。

代码：

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

namespace Demo
{
    [ContentProperty(nameof(Children))]  // Prior to C# 6.0, replace nameof(Children) with "Children"
    public partial class MultiChildDemo : UserControl
    {
        public static readonly DependencyPropertyKey ChildrenProperty = DependencyProperty.RegisterReadOnly(
            nameof(Children),  // Prior to C# 6.0, replace nameof(Children) with "Children"
            typeof(UIElementCollection),
            typeof(MultiChildDemo),
            new PropertyMetadata());

        public UIElementCollection Children
        {
            get { return (UIElementCollection)GetValue(ChildrenProperty.DependencyProperty); }
            private set { SetValue(ChildrenProperty, value); }
        }

        public MultiChildDemo()
        {
            InitializeComponent();
            Children = PART_Host.Children;
        }
    }
}

MultiChildDemoWindow.xaml

请注意标签如何成为 元素的直接后代。您还可以将它们包含在 元素中。不过，我们添加到 MultiChild 类中的 ContentPropertyAttribute 属性允许我们省略此步骤。

代码：

<Window x:Class="Demo.MultiChildDemoWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:demo="clr-namespace:Demo"
        Title="MultiChildDemoWindow" Height="300" Width="300">
    <demo:MultiChildDemo>
        <Label>Test 1</Label>
        <Label>Test 2</Label>
        <Label>Test 3</Label>
    </demo:MultiChildDemo>
</Window>

Answer 2

只需删除 UserControl 标签并替换为 Grid

Answer 3

首先尝试了解 用户控件之间的区别 和自定义控件 (控制/内容控制< /a>)

为了简单起见：

“标准 WPF 控件提供了大量内置功能
功能。如果预设控件之一的功能，
例如进度条或滑块，与您想要的功能相匹配
想要合并，那么您应该为此创建一个新模板
预先存在的控件来实现您想要的外观。创建一个新的
模板是创建自定义元素最简单的解决方案，因此您
应该首先考虑该选项。

如果您想要合并到应用程序中的功能可以
通过组合现有的控件和代码来实现，
考虑创建一个用户控件。用户控件使您能够绑定
将多个预先存在的控件放在一个界面中并添加
决定它们行为方式的代码。

如果没有现有的控件或控件组合可以实现
您想要的功能，创建自定义控件。自定义控件
使您能够创建一个定义视觉效果的全新模板
控件的表示并添加确定的自定义代码
控件的功能。”

Adam Nathan - WPF Unleashed 4

现在，如果您想要的只是一个 ContentControl：

1. 创建一个派生 ContentControl 的新 CustomControl
2. 在主题中找到 generic.xaml 并将 Content Presenter 添加到您的控件模板中。如上所述，自定义控件控制逻辑与其视觉呈现分离
3. 使用该控件作为常规 ContentControl

对于作为内容的多个项目，请查看 ItemsControl

上述步骤修改为：

Derive Items控件

public class MyCtrl : ItemsControl
{
    static MyCtrl()
    {
        DefaultStyleKeyProperty.OverrideMetadata(typeof(MyCtrl), new FrameworkPropertyMetadata(typeof(MyCtrl)));
    }
}

修改 Generic.xaml 以包含 ItemsPresenter

<Style TargetType="{x:Type local:MyCtrl}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:MyCtrl}">
                <Border Background="{TemplateBinding Background}"
                        BorderBrush="{TemplateBinding BorderBrush}"
                        BorderThickness="{TemplateBinding BorderThickness}">
                    <ItemsPresenter />
                </Border>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

使用控件

<StackPanel>
    <ctrl:MyCtrl>
        <Button Width="100" Height="50">Click</Button>
        <Button Width="100" Height="50">Click</Button>
        <Button Width="100" Height="50">Click</Button>
    </ctrl:MyCtrl>
</StackPanel>

如上所述，对于这个简单的情况，不需要派生 ItemsControl，而只需使用 ItemsControl 并为其定义一个模板。计划通过添加功能进行扩展时派生 ItemsControl

编辑：

边框（请参阅xaml）不会在设计器中显示，并且在应用程序运行时不会显示，甚至没有边距

您应该在控件本身上设置 Border 属性：

<ctrl:MyCtrl BorderBrush="Red" BorderThickness="3" Background="Green" >