WPF MVVM模式下多维复杂对象模型的绑定包装实现及PropertyPath原理问询

Hi there! Let's break this down into two clear parts: wrapping your GameBoard model with minimal boilerplate while keeping proper separation, and explaining how PropertyPath and OnPropertyChanged work under the hood.

1. 以最小样板代码包装GameBoard（保留原Model结构） #

首先提个小细节：你的GameBoard类里有个小bug——构造函数里Height和Width的赋值搞反了（把width赋值给了Height，height赋值给了Width），记得先修正这个问题，避免维度匹配错误！

既然你想完全保留原Model的结构，核心思路就是让ViewModel成为修改Cell.IsOn的唯一入口（这样才能触发变更通知），同时持有原GameBoard的实例。下面是优化后的ViewModel实现，能完美适配WPF绑定：

using CommunityToolkit.Mvvm.ComponentModel;
using System.Windows;

internal partial class BoardViewModel : ObservableObject
{
    [ObservableProperty] int width = 5;
    [ObservableProperty] int height = 5;
    private readonly GameBoard _gameBoard;

    public BoardViewModel()
    {
        // 这里也要修正GameBoard构造函数的参数顺序
        _gameBoard = new GameBoard(Width, Height);
    }

    // 二维索引器，直接访问/修改Cell.IsOn
    public bool this[int y, int x]
    {
        get => _gameBoard[y][x].IsOn;
        set
        {
            if (_gameBoard[y][x].IsOn == value) return; // 值未变化，跳过通知

            _gameBoard[y][x].IsOn = value;
            // 通知绑定引擎该索引器条目已变更
            // WPF能识别"[y,x]"或"Item[y,x]"两种默认索引器写法
            OnPropertyChanged($"[{y},{x}]");
        }
    }

    // 适配View中点击事件的Point类型重载
    public bool this[Point location]
    {
        get => this[(int)location.Y, (int)location.X];
        set => this[(int)location.Y, (int)location.X] = value;
    }

    // 若其他绑定需要，可暴露原GameBoard实例
    public GameBoard GameBoard => _gameBoard;
}

接着修改View中的绑定逻辑，让它指向ViewModel的索引器而非嵌套的Board属性：

// 在UserControl_Loaded方法中，替换绑定代码为：
var binding = new Binding()
{
    Source = viewModel,
    // 路径指向ViewModel的二维索引器
    Path = new PropertyPath($"[{y},{x}]"),
    Converter = new IsOnToFillConverter()
};

这种方案完全隔离了Model和View，样板代码极少，所有UI更新都通过标准MVVM变更通知触发。记住所有对Cell.IsOn的修改都要通过ViewModel的索引器，这样就不会漏掉UI刷新的通知。

2. OnPropertyChanged结合PropertyPath的底层原理 #

什么是PropertyPath？ #

PropertyPath是WPF用来描述绑定源对象上值的「导航路径」的工具，它可以定位：

• 简单属性（比如"IsOn"）
• 嵌套属性（比如"Cell.IsOn"）
• 索引器（比如二维索引器的"[0,1]"、集合条目的"Items[5]"）
• 附加属性（比如"(Canvas.Top)"）

它就像给绑定引擎的一张路线图，告诉它该去哪里找到需要同步到UI的具体值。

调用OnPropertyChanged时到底发生了什么？ #

当你的ViewModel调用OnPropertyChanged("[y,x]")时：

1. INotifyPropertyChanged.PropertyChanged事件触发，把属性路径字符串发送给所有订阅者（包括WPF的绑定引擎）。
2. 绑定引擎检查是否有活跃绑定的PropertyPath与通知的路径匹配（或依赖于该路径）——在你的场景里，就是Rectangle的Fill属性绑定的[y,x]路径。
3. 绑定引擎重新在ViewModel上计算该路径：调用索引器viewModel[y,x]获取最新的bool值。
4. 这个值会通过IsOnToFillConverter转换成对应的Brush，最终更新Rectangle的Fill属性。

你之前的静态绑定无法更新UI，就是因为原Model没有实现INotifyPropertyChanged，属性变化时无法通知绑定引擎。通过在ViewModel中包装访问逻辑并触发OnPropertyChanged，你就给了绑定引擎刷新UI的信号。

关于你最初尝试的小提醒 #

你最初的ViewModel思路已经很接近了，但OnPropertyChanged调用的"board[{y},{x}]"和绑定路径不匹配——当时绑定指向的是ViewModel的Board属性的索引器，而我们现在改成了让ViewModel直接暴露索引器，这样访问更简洁，通知也更准确。

备注：内容来源于stack exchange，提问作者ycsvenom