WinUI3 ListView选中项边框不显示问题排查求助

你遇到的SelectedBorderThickness设置后无效果，主要有以下核心原因及解决方式：

核心原因 #

UWP的ListViewItemPresenter选中状态的边框样式，默认由**视觉状态（VisualState）**控制，直接在Presenter上设置SelectedBorderThickness和SelectedBorderBrush不会覆盖视觉状态里的默认定义，因此无法生效。

解决办法 #

方法1：修改ControlTemplate的视觉状态 #

在ControlTemplate中添加VisualStateManager，针对选中相关状态（Selected、SelectedPointerOver等）明确设置边框样式：

<ControlTemplate TargetType="ListViewItem">
    <ListViewItemPresenter x:Name="Root"
                           SelectionCheckMarkVisualEnabled="False"
                           CheckHintBrush="#FF0000"
                           CheckBoxBrush="#00000000"
                           ContentTransitions="{TemplateBinding ContentTransitions}"
                           DragBackground="{ThemeResource ListViewItemDragBackgroundThemeBrush}"
                           DragForeground="{ThemeResource ListViewItemDragForegroundThemeBrush}"
                           FocusBorderBrush="{ThemeResource SystemControlForegroundAltHighBrush}"
                           FocusSecondaryBorderBrush="{ThemeResource SystemControlForegroundBaseHighBrush}"
                           PlaceholderBackground="{ThemeResource ListViewItemPlaceholderBackgroundThemeBrush}"
                           PointerOverBackground="{ThemeResource SystemControlHighlightListLowBrush}"
                           PointerOverForeground="{ThemeResource SystemControlForegroundBaseHighBrush}"
                           PressedBackground="{ThemeResource SystemControlHighlightListMediumBrush}"
                           DisabledOpacity="{ThemeResource ListViewItemDisabledThemeOpacity}"
                           DragOpacity="1"
                           ReorderHintOffset="{ThemeResource ListViewItemReorderHintThemeOffset}"
                           HorizontalContentAlignment="{TemplateBinding HorizontalContentAlignment}"
                           VerticalContentAlignment="{TemplateBinding VerticalContentAlignment}"
                           ContentMargin="1"
                           CheckMode="Overlay">
        <VisualStateManager.VisualStateGroups>
            <VisualStateGroup x:Name="SelectionStates">
                <VisualState x:Name="Unselected"/>
                <VisualState x:Name="Selected">
                    <VisualState.Setters>
                        <Setter Target="Root.BorderThickness" Value="2"/>
                        <Setter Target="Root.BorderBrush" Value="#FF0000"/>
                    </VisualState.Setters>
                </VisualState>
                <VisualState x:Name="SelectedPointerOver">
                    <VisualState.Setters>
                        <Setter Target="Root.BorderThickness" Value="2"/>
                        <Setter Target="Root.BorderBrush" Value="#FF0000"/>
                    </VisualState.Setters>
                </VisualState>
                <VisualState x:Name="SelectedPressed">
                    <VisualState.Setters>
                        <Setter Target="Root.BorderThickness" Value="2"/>
                        <Setter Target="Root.BorderBrush" Value="#FF0000"/>
                    </VisualState.Setters>
                </VisualState>
            </VisualStateGroup>
        </VisualStateManager.VisualStateGroups>
    </ListViewItemPresenter>
</ControlTemplate>

方法2：自定义Item容器模板（替代ListViewItemPresenter） #

放弃使用ListViewItemPresenter，改用Border包裹ContentPresenter，通过触发器绑定IsSelected属性控制边框：

<Style TargetType="ListViewItem">
    <Setter Property="Margin" Value="0"/>
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="ListViewItem">
                <Border x:Name="RootBorder"
                        BorderThickness="0"
                        BorderBrush="Transparent"
                        Background="{TemplateBinding Background}">
                    <ContentPresenter HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}"
                                      VerticalAlignment="{TemplateBinding VerticalContentAlignment}"
                                      Margin="{TemplateBinding Padding}"/>
                </Border>
                <ControlTemplate.Triggers>
                    <Trigger Property="IsSelected" Value="True">
                        <Setter Target="RootBorder.BorderThickness" Value="2"/>
                        <Setter Target="RootBorder.BorderBrush" Value="#FF0000"/>
                    </Trigger>
                    <Trigger Property="IsPointerOver" Value="True">
                        <Setter Target="RootBorder.Background" Value="{ThemeResource SystemControlHighlightListLowBrush}"/>
                    </Trigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

额外注意点 #

• 你当前设置的BorderThickness="3"是未选中状态的默认边框，若不需要可改为0，避免与选中边框冲突。
• 由于SelectionMode为Multiple，需确保视觉状态覆盖所有选中相关场景（如选中+鼠标悬停、选中+按下等）。

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