用途:解决 WPF 中 Slider 绑定 0 基索引、但需要向用户显示 1 基编号的问题。典型症状是 120 张图片显示为“0 / 120”到“119 / 120”,用户期望“1 / 120”到“120 / 120”,且拖到末端无法到达最后一项。原因是 Slider 的 Maximum 若设为总数会超出有效范围,直接显示 0 基索引也会让用户困惑。
主要能力:在 ViewModel 中增加显示属性。CurrentSliceIndex 为内部 0 基索引,范围 0 到 Count-1,作为 Slider 的 Value;MaxSliceIndex 为 Count-1,作为 Slider 的 Maximum;SliceDisplayNumber 为 CurrentSliceIndex+1,用于用户显示;TotalSliceCount 用于显示总数。使用 CommunityToolkit.Mvvm 的 [ObservableProperty] 与 [NotifyPropertyChangedFor] 特性,当源属性变化时自动为计算属性触发 PropertyChanged。
使用方式:XAML 中用三列 Grid,左列 TextBlock 绑定 SliceDisplayNumber,中间 Slider 设置 Minimum=0、Maximum 绑定 MaxSliceIndex、Value 绑定 CurrentSliceIndex,右列 TextBlock 绑定 TotalSliceCount。
适用场景:图像查看器切片导航(CT/MRI)、文档查看器分页、媒体播放器曲目列表、图库图片索引。
限制:资料未提供具体依赖版本、安装命令或完整项目配置,需自行按 CommunityToolkit.Mvvm 用法接入;其余细节暂未提供。