WinUI 3自定义UserControl鼠标事件无法触发问题求助

问题场景 #

开发WinUI3应用时，自定义Task UserControl并绑定PointerPressed、PointerEntered事件，但将其添加到ListView后，这些事件完全无法触发，尝试在UserControl、内部StackPanel、TextBlock上绑定事件均无效。

核心原因 #

直接将UserControl实例添加到ListView.Items集合时，WinUI3会自动将每个Item包装在ListViewItem容器中。默认情况下，ListViewItem会优先处理鼠标事件，导致内部UserControl的事件无法被触发；同时这种直接添加控件的方式不符合ListView的设计模式，容易引发事件路由问题。

解决方案 #

1. 使用ListView的ItemTemplate正确渲染内容 #

这是ListView的标准用法，通过绑定数据源+ItemTemplate来展示内容，确保事件能正常传递：

修改窗口XAML中的ListView配置

<ListView Name="tasksPanel" VerticalAlignment="Top" HorizontalAlignment="Left">
    <ListView.ItemTemplate>
        <DataTemplate x:DataType="local:Task">
            <local:Task />
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

修改添加Item的C#代码

不再直接添加UserControl实例，而是添加数据对象：

private async void Window_Activated(object sender, WindowActivatedEventArgs args)
{
    Activated -= Window_Activated;
    // 添加数据对象而非UserControl实例
    tasksPanel.Items.Add(new Task(0, 12, 0, 25, "test task", null, 0, "test priority", 25, DateTime.Today, 25, DateTime.Today, true, DateTime.Today));
}

2. 确保元素可被命中测试 #

检查UserControl及内部元素的IsHitTestVisible属性（默认值为True，若被意外设置为False会导致无法捕获事件），可显式设置：

<UserControl
    ...
    IsHitTestVisible="True">
    <StackPanel Name="stackPanel" Orientation="Horizontal" 
                PointerPressed="Task_PointerPressed" 
                PointerEntered="Task_PointerEntered" 
                Background="Red"
                IsHitTestVisible="True">
        <TextBlock Name="projectNum" Width="100" Margin="10,10,10,10" TextAlignment="Center" IsHitTestVisible="True"/>
        <TextBlock Name="taskName" Width="750" Margin="10,10,10,10" TextAlignment="Left" IsHitTestVisible="True"/>
        <TextBlock Name="assignedBy" Width="100" Margin="10,10,10,10" TextAlignment="Left" IsHitTestVisible="True"/>
        
        <StackPanel.ContextFlyout>
            <MenuFlyout>
                <MenuFlyoutItem Name="test" Icon="setting" Text="test"/>
            </MenuFlyout>
        </StackPanel.ContextFlyout>
    </StackPanel>
</UserControl>

3. 拦截ListViewItem的事件（备选方案） #

如果必须保留直接添加UserControl的方式，可以通过处理ListView的ContainerContentChanging事件，在ListViewItem上绑定事件：

private void tasksPanel_ContainerContentChanging(ListViewBase sender, ContainerContentChangingEventArgs args)
{
    if (args.Item is Task taskControl)
    {
        var listViewItem = args.ItemContainer as ListViewItem;
        listViewItem.PointerPressed += (s, e) => taskControl.Task_PointerPressed(s, e);
        listViewItem.PointerEntered += (s, e) => taskControl.Task_PointerEntered(s, e);
    }
}

同时在窗口XAML的ListView上添加该事件绑定：

<ListView Name="tasksPanel" VerticalAlignment="Top" HorizontalAlignment="Left" ContainerContentChanging="tasksPanel_ContainerContentChanging"/>

验证修改 #

完成上述任一方案后，运行应用，点击或 hover 自定义Task控件，查看输出窗口的Trace.WriteLine内容，即可确认事件是否正常触发。

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