WPF 中巢狀 `ScrollViewer` (或 `ListBox`/`ListView` 內建 `ScrollViewer`) 會「吞噬」滑鼠滾輪事件,導致外層無法滾動。解決方法是攔截內層 `PreviewMouseWheel` 事件,手動建立新事件轉發給外層 `ScrollViewer`。
<ScrollViewer x:Name="OuterScroll" VerticalScrollBarVisibility="Auto">
<StackPanel>
<TextBlock Text="Header..." />
<ListBox x:Name="InnerList" Height="300"
ScrollViewer.VerticalScrollBarVisibility="Disabled"
ScrollViewer.HorizontalScrollBarVisibility="Disabled">
<ListBoxItem>Item 1</ListBoxItem>
<ListBoxItem>Item 2</ListBoxItem>
<!-- 大量項目 -->
</ListBox>
<TextBlock Text="Footer..." />
</StackPanel>
</ScrollViewer>
關鍵:內層 `ListBox` **停用** 自己的 ScrollBar (`Disabled`),滾動完全交給外層。
public MainWindow()
{
InitializeComponent();
Loaded += (s, e) =>
{
// 找到內層 ScrollViewer (ListBox 內建)
var innerScroll = FindVisualChild<ScrollViewer>(InnerList);
if (innerScroll != null)
{
innerScroll.PreviewMouseWheel += (sender, args) =>
{
// 建立新的滾輪事件,路由給外層
var newArgs = new MouseWheelEventArgs(args.MouseDevice, args.Timestamp, args.Delta)
{
RoutedEvent = UIElement.MouseWheelEvent,
Source = sender
};
innerScroll.RaiseEvent(newArgs); // 事件會冒泡到 OuterScroll
args.Handled = true; // 可選:標記已處理,防止內層再處理 (但內層已 Disabled)
};
}
};
}
// 尋找視覺樹中指定類型的子元素
public static T FindVisualChild<T>(DependencyObject parent) where T : DependencyObject
{
for (int i = 0; i < VisualTreeHelper.GetChildrenCount(parent); i++)
{
var child = VisualTreeHelper.GetChild(parent, i);
if (child is T result) return result;
var descendant = FindVisualChild<T>(child);
if (descendant != null) return descendant;
}
return null;
}
public static class ScrollViewerHelper
{
public static readonly DependencyProperty BubbleWheelProperty =
DependencyProperty.RegisterAttached("BubbleWheel", typeof(bool), typeof(ScrollViewerHelper),
new PropertyMetadata(false, OnBubbleWheelChanged));
public static void SetBubbleWheel(DependencyObject element, bool value) => element.SetValue(BubbleWheelProperty, value);
public static bool GetBubbleWheel(DependencyObject element) => (bool)element.GetValue(BubbleWheelProperty);
private static void OnBubbleWheelChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
if (d is UIElement element && (bool)e.NewValue)
{
element.PreviewMouseWheel += (sender, args) =>
{
var newArgs = new MouseWheelEventArgs(args.MouseDevice, args.Timestamp, args.Delta)
{
RoutedEvent = UIElement.MouseWheelEvent,
Source = sender
};
element.RaiseEvent(newArgs);
};
}
}
}
<ListBox x:Name="InnerList" local:ScrollViewerHelper.BubbleWheel="True" ... />
若 UI 允許,**將內層 `ListBox` 設為 `ScrollViewer.CanContentScroll=False` 並移除其內建 ScrollViewer**,改用 `VirtualizingStackPanel` 配合外層單一 `ScrollViewer`,效能最好、邏輯最簡單:
<ScrollViewer>
<ItemsControl ItemsSource="{Binding Items}" VirtualizingStackPanel.IsVirtualizing="True" VirtualizingStackPanel.VirtualizationMode="Recycling">
<ItemsControl.ItemsPanel>
<ItemsPanelTemplate><VirtualizingStackPanel /></ItemsPanelTemplate>
</ItemsControl.ItemsPanel>
</ItemsControl>
</ScrollViewer>