萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

WPF 解決巢狀 ScrollViewer 滾動衝突 (滑鼠滾輪傳遞)

前言

WPF 中巢狀 `ScrollViewer` (或 `ListBox`/`ListView` 內建 `ScrollViewer`) 會「吞噬」滑鼠滾輪事件,導致外層無法滾動。解決方法是攔截內層 `PreviewMouseWheel` 事件,手動建立新事件轉發給外層 `ScrollViewer`。

XAML 結構範例

<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`),滾動完全交給外層。

後台程式碼 (代碼後置或 Behavior)

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;
}

通用 Attached Behavior (可在 XAML 直接套用)

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);
            };
        }
    }
}

XAML 使用 Behavior

<ListBox x:Name="InnerList" local:ScrollViewerHelper.BubbleWheel="True" ... />

替代方案:僅用單一 ScrollViewer

若 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>
copyright © 萬盛學電腦網 all rights reserved