WPF ItemsControl模板不显示Items及可替换控件样式/模板创建需求

嘿，这两个问题都是WPF开发里ItemsControl的常见坑，我来一步步帮你搞定：

一、为什么你的ItemsControl模板不显示Items？ #

本质原因很简单——你自定义的模板里漏掉了ItemsPresenter这个核心元素！

WPF里的ItemsPresenter是专门负责渲染ItemsControl的Items集合（或者绑定的ItemsSource）的载体。如果你的模板里没有它，不管你怎么往Items里塞内容，或者怎么绑定数据源，界面上都不会有任何东西显示出来。

举个错误示范，这样写肯定看不到Items：

<ControlTemplate TargetType="ItemsControl">
    <!-- 只有边框，没有ItemsPresenter，白搭 -->
    <Border BorderBrush="Gray" BorderThickness="1"/>
</ControlTemplate>

正确的模板必须包含ItemsPresenter，它会自动关联你设置的ItemContainerStyle、ItemsPanel这些配置：

<ControlTemplate TargetType="ItemsControl">
    <Border BorderBrush="{TemplateBinding BorderBrush}" 
            BorderThickness="{TemplateBinding BorderThickness}"
            Padding="{TemplateBinding Padding}">
        <!-- 这个就是让Items显示出来的关键！ -->
        <ItemsPresenter/>
    </Border>
</ControlTemplate>

二、创建无需手动写Items、还能替换控件的可复用样式 #

根据你给的XAML代码，我们可以把所有重复的配置（比如ItemContainerStyle、ItemsPanel、模板）打包成一个通用样式，这样你不用每次都写一堆重复代码，还能轻松把样式用到不同的ItemsControl派生控件上。

完整的可复用样式代码 #

<Window.Resources>
    <!-- 先定义可复用的ItemsPanel，这里用横向StackPanel，你可以随便改 -->
    <ItemsPanelTemplate x:Key="HorizontalStackPanelPanel">
        <StackPanel Orientation="Horizontal" IsItemsHost="True"/>
    </ItemsPanelTemplate>

    <!-- 核心通用样式，适用于所有ItemsControl -->
    <Style x:Key="ItemsControlWithMargin1" TargetType="{x:Type ItemsControl}">
        <Setter Property="Height" Value="50"/>
        <!-- 你要的ItemContainerStyle，给每个子项加左边距 -->
        <Setter Property="ItemContainerStyle">
            <Setter.Value>
                <Style TargetType="Control">
                    <Setter Property="Margin" Value="15 0 0 0"/>
                </Style>
            </Setter.Value>
        </Setter>
        <Setter Property="ItemsPanel" Value="{StaticResource HorizontalStackPanelPanel}"/>
        <!-- 自带正确的模板，确保Items能显示 -->
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="{x:Type ItemsControl}">
                    <Border Background="{TemplateBinding Background}"
                            BorderBrush="{TemplateBinding BorderBrush}"
                            BorderThickness="{TemplateBinding BorderThickness}"
                            Padding="{TemplateBinding Padding}">
                        <ItemsPresenter/>
                    </Border>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>

    <!-- 要替换控件？比如换成ListBox，直接继承基础样式就行 -->
    <Style x:Key="ListBoxWithMargin1" TargetType="{x:Type ListBox}" BasedOn="{StaticResource ItemsControlWithMargin1}">
        <!-- 这里可以加ListBox特有的设置，比如选中样式、选择模式 -->
        <Setter Property="SelectionMode" Value="Single"/>
    </Style>
</Window.Resources>

怎么用？超简单！ #

1. 用在普通ItemsControl上，只需要绑定数据源就行，不用写ItemsControl.Items：

<ItemsControl Style="{DynamicResource ItemsControlWithMargin1}"
              ItemsSource="{Binding YourDataList}"/>

2. 换成ListBox（或者其他ItemsControl派生类），直接用继承的样式：

<ListBox Style="{DynamicResource ListBoxWithMargin1}"
         ItemsSource="{Binding YourDataList}"/>

划重点 #

• 不用手动写Items：通过ItemsSource绑定数据源，符合MVVM的最佳实践，维护起来更方便。
• 控件随便换：利用WPF样式的BasedOn特性，继承基础样式后可以轻松扩展到ListBox、ListView等控件，不用重复写配置。
• 动态资源支持：用DynamicResource可以让你在运行时修改样式，灵活性拉满。

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