VB.NET中如何通过指定索引选中ListViewItem项

实现点击按钮选中ListView第5行的核心逻辑如下，注意规避几个常见的容易导致失效的配置问题：

• ListView的项索引默认从0开始计数，视觉上的第5行对应的索引值为4，直接传5会选到第6行，甚至触发索引越界异常
• 仅设置项的Selected属性不足以保证选中态正常显示，必须同步设置焦点项、处理原有选中态
• 如果需要选中项自动滚动到用户可视范围，需要额外调用可视性保障方法

可直接复用的实现代码 #

在按钮的Click事件中添加如下代码即可：

Private Sub btnSelectRow_Click(sender As Object, e As EventArgs) Handles btnSelectRow.Click
    ' 目标行：视觉第5行对应0基索引4
    Dim targetIndex As Integer = 4
    ' 先判断索引合法性，避免项数不足时报错
    If ListView1.Items.Count <= targetIndex Then Exit Sub

    ' 清除之前的选中状态，不需要清空多选结果可注释该行
    ListView1.SelectedItems.Clear()

    ' 标记目标项为选中状态
    ListView1.Items(targetIndex).Selected = True
    ' 设置焦点项，确保选中高亮正常渲染
    ListView1.Items(targetIndex).Focused = True
    ' 自动滚动到目标项所在位置，保证用户能直接看到选中行
    ListView1.EnsureVisible(targetIndex)
    ' 让ListView获得焦点，避免失焦状态下选中高亮显示过浅
    ListView1.Select()
End Sub

常见失效原因排查 #

90%以上的选中失效场景都是以下原因导致，逐一核对即可：

1. 漏设Focused属性，导致选中态没有高亮，误以为功能没生效
2. 控件HideSelection属性保持默认值True，当ListView没有获得输入焦点时，选中项不会显示高亮，可手动将该属性设为False解决
3. 索引计数错误，把视觉行号直接当索引用，传入了错误的索引值
4. 没有判断项总数，当ListView项数不足5行时，直接访问索引4会触发运行时错误

可选配置调整 #

• 不需要多选功能时，可将ListView的MultiSelect属性设为False，交互逻辑更符合单选场景
• 需要保留原有多选结果时，删除代码中ListView1.SelectedItems.Clear()这一行即可
• 如果不需要自动滚动到选中行，可删除EnsureVisible相关调用

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