WPF中ElementName/RelativeSource绑定在ListBox失效但子项可用

你的问题核心不是绑定失效，而是WPF布局系统的约束传递逻辑和不同控件的布局行为差异导致绑定的约束没有产生预期效果，具体拆解如下：

1. Image上绑定MaxWidth生效的本质 #

Image是内容显示控件，默认不会自动拉伸填充父容器（除非设置Stretch属性）。当你给Image的MaxWidth绑定到Window的ActualWidth时，这个值会直接限制Image的最大渲染尺寸——一旦Image的原始宽度超过Window宽度，就会被截断到Window宽度，因此不会超出边界。

另外，DataTemplate的命名范围虽然独立，但通过ElementName=Root（Window的顶级命名容器）或RelativeSource可以正确找到Window的ActualWidth值，绑定本身是有效的。

2. 绑定到ListBox/外层Grid失效的原因 #

（1）约束冗余，未产生实际限制 #

外层Grid和ListBox默认的布局行为是拉伸填充父容器：

• Grid作为Window的直接子元素，会自动占满Window的全部可用宽度；
• ListBox作为Grid的直接子元素，同样会继承Grid的宽度，等于Window的宽度。

此时你给它们绑定MaxWidth={Binding ElementName=Root, Path=ActualWidth}，本质是设置了一个和控件当前可用空间完全相等的上限——这个约束没有任何实际限制作用，控件本来就只能拿到这么多空间，自然不会改变布局结果。

（2）ListBox内部的滚动容器导致内容溢出 #

ListBox默认内置ScrollViewer，当内部Item的尺寸超过ListBox自身尺寸时，会自动显示横向/纵向滚动条。你看到的“图片超出Window边界”，实际是ListBox内部的Item（Image）没有被限制宽度，导致ScrollViewer出现横向滚动，看起来像是ListBox超出了Window，但ListBox本身的宽度是符合Window宽度的。

（3）约束未传递到子项 #

ListBox的外部尺寸约束不会自动传递到ItemTemplate内的元素。ListBox的Item容器（ListBoxItem）默认是拉伸的，但Image如果没有设置MaxWidth或Stretch，会按原始尺寸渲染，不受ListBox外部宽度的限制。

验证方法 #

你可以通过以下方式确认绑定本身是有效的：

• 在代码后台给ListBox的MaxWidth绑定添加UpdateSourceTrigger=PropertyChanged，然后在运行时调整Window宽度，查看ListBox的MaxWidth是否同步变化（可以用Snoop工具查看控件属性）；
• 给ListBox绑定一个比Window宽度小的值（比如MaxWidth={Binding ElementName=Root, Path=ActualWidth, Converter={StaticResource MultiplyConverter}, ConverterParameter=0.8}），此时ListBox会被限制到Window宽度的80%，说明绑定是生效的。

正确的约束方式 #

如果要让所有图片都不超出Window宽度，应该在ItemTemplate内部的元素上设置约束，比如：

1. 保持Image的MaxWidth绑定（最直接的方式）；
2. 给Image设置Stretch="Uniform"，同时让Image的父容器（DataTemplate内的Grid）继承ListBoxItem的宽度：

<ListBox ItemsSource="{Binding Scans}">
    <ListBox.ItemTemplate>
        <DataTemplate DataType="{x:Type models:Scan}">
            <Grid HorizontalAlignment="Stretch">
                <Image Stretch="Uniform" Source="{Binding Thumbnail}" />
            </Grid>
        </DataTemplate>
    </ListBox.ItemTemplate>
</ListBox>

这种方式下，Grid会拉伸填充ListBoxItem的宽度，Image会按比例缩放以适应Grid的宽度，不会超出Window边界。

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