WPF如何配置自定义控件以支持直接添加多个子元素？

你当前的MenuButtonControl需要支持在XAML标签内部直接添加Button等UI元素，核心问题出在依赖属性注册错误以及未配置内容属性映射，以下是修复步骤：

1. 修正依赖属性注册错误 #

你在注册MenuItemsProperty时，错误地将属性名写为"ItemTemplate"，这会导致绑定失效；同时需要将集合类型改为ObservableCollection<UIElement>（支持自动通知集合变化），并添加[ContentProperty]特性，标记MenuItems为控件的内容属性，这样XAML中的子元素会自动被收集到该集合中。

2. 修改后台代码（MenuButtonControl.xaml.cs） #

using System.Collections.ObjectModel;
using System.Windows;
using System.Windows.Controls;

[ContentProperty(nameof(MenuItems))]
public partial class MenuButtonControl : UserControl
{
    public MenuButtonControl()
    {
        InitializeComponent();
        DataContext = this;
        // 初始化集合，避免空引用
        MenuItems = new ObservableCollection<UIElement>();
    }

    public static readonly DependencyProperty MenuItemsProperty =
        DependencyProperty.Register(nameof(MenuItems), typeof(ObservableCollection<UIElement>), typeof(MenuButtonControl), new PropertyMetadata(null));
    
    public ObservableCollection<UIElement> MenuItems
    {
        get { return (ObservableCollection<UIElement>)GetValue(MenuItemsProperty); }
        set { SetValue(MenuItemsProperty, value); }
    }
}

3. 优化XAML绑定（可选） #

虽然当前DataContext = this可以工作，但更规范的方式是使用RelativeSource绑定，避免DataContext被外部覆盖：

<UserControl
    ...
    xmlns:local="clr-namespace:YourNamespace">
    <Grid>
        <ItemsControl
            x:Name="tStack"
            ItemsSource="{Binding MenuItems, RelativeSource={RelativeSource AncestorType=local:MenuButtonControl}}"
            Visibility="{Binding IsChecked, ElementName=toggleButton, Converter={StaticResource BoolToVisibilityConverter}}">
            <ItemsControl.ItemsPanel>
                <ItemsPanelTemplate>
                    <StackPanel Orientation="Horizontal" />
                </ItemsPanelTemplate>
            </ItemsControl.ItemsPanel>
            <!-- 移除多余ItemTemplate：ItemsSource为UIElement集合时，控件会直接渲染元素 -->
        </ItemsControl>

        <ToggleButton x:Name="toggleButton" Content="Toggle" />
    </Grid>
</UserControl>

4. 验证使用方式 #

现在你可以像示例那样直接添加子元素：

<Controls:MenuButtonControl Grid.Row="1">
    <Button Content="Test 1" />
    <Button Content="Test 2" />
    <Button Content="Test 3" />
</Controls:MenuButtonControl>

关键说明 #

• [ContentProperty(nameof(MenuItems))]：告诉WPF解析XAML时，将控件标签内的子元素自动赋值给MenuItems属性
• 初始化ObservableCollection：确保集合不为空，添加子元素时能正确触发集合变化通知
• 移除多余ItemTemplate：当ItemsSource是UIElement集合时，ItemsControl会直接渲染元素，无需额外模板

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