BrightIdeasSoftware TreeListView新增节点无法选中并显示问题排查

核心问题分析 #

你的代码存在操作冗余、顺序混乱，且未处理「TreeListView未获得焦点」「模型对应的Item未完成创建」这两个关键场景，导致滚动和选中逻辑失效。

修正后的实现代码 #

public void EnsureNodeIsVisible(object item)
{
    // 前提：调用此方法前，必须确保item已添加到TreeListView的Objects集合中
    // 选中目标节点
    treeListView.SelectedObject = item;

    // 展开目标节点（如果需要默认展开当前节点）
    treeListView.Expand(item);

    // 展开所有父节点并滚动到目标节点位置（BrightIdeas内置方法已包含滚动逻辑）
    treeListView.EnsureModelVisible(item);

    // 获取对应的ListViewItem，确保Item已被TreeListView创建
    var olvItem = treeListView.ModelToItem(item);
    if (olvItem != null)
    {
        // 设置焦点到目标Item，确保选中状态的视觉反馈
        treeListView.FocusedItem = olvItem;
        // 强制滚动兜底（避免EnsureModelVisible因UI延迟失效）
        olvItem.EnsureVisible();
        // 让TreeListView本身获得焦点，保证滚动和选中状态正常生效
        treeListView.Focus();
    }
}

// 若存在Item未及时创建的情况（比如刚添加模型就调用方法），可改用异步调用（WinForms示例）
public void EnsureNodeIsVisibleAsync(object item)
{
    treeListView.BeginInvoke(new Action(() =>
    {
        treeListView.SelectedObject = item;
        treeListView.Expand(item);
        treeListView.EnsureModelVisible(item);
        
        var olvItem = treeListView.ModelToItem(item);
        if (olvItem != null)
        {
            treeListView.FocusedItem = olvItem;
            olvItem.EnsureVisible();
            treeListView.Focus();
        }
    }));
}

关键修复点 #

1. 移除冗余操作：删除重复的EnsureVisible、ScrollToIndex等调用，避免逻辑冲突
2. 补充焦点设置：添加treeListView.Focus()，如果控件本身无焦点，滚动和选中的视觉反馈会失效
3. 处理Item创建延迟：通过BeginInvoke异步执行逻辑，确保TreeListView完成模型到Item的转换
4. 简化逻辑顺序：先选中节点，再展开（可选），最后调用内置的EnsureModelVisible完成父节点展开和滚动

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