TreeView节点图片偶发不显示，选中节点时ImageIndex失效问题咨询

问题背景 #

已为TreeView绑定ImageList，代码如下：

mlstImg.Images.Add(Resources.EMPTY);
mlstImg.Images.Add(Resources.MIXED);
mlstImg.Images.Add(Resources.DOWN);
mlstImg.Images.Add(Resources.UP);
this.TreeViewSites.ImageList = mlstImg;
this.TreeViewSites.ImageKey = null;
this.TreeViewSites.SelectedImageIndex = -1;
this.TreeViewSites.SelectedImageKey = null;

遇到的问题：

• 部分节点图片未显示，但确认每个节点都已设置ImageIndex
• 节点展开时设置ImageIndex无效
• 节点被选中时，设置ImageIndex无效果

环境信息：

IDE: Microsoft Visual Studio Professional 2022 (64-bit), Version 17.8.6
OS: Microsoft Windows [10.0.19045.4291]

解决思路与方案 #

1. 区分ImageIndex与SelectedImageIndex #

TreeView节点有两个图标属性：

• ImageIndex：节点未选中时显示的图标索引
• SelectedImageIndex：节点选中时显示的图标索引

你当前设置了TreeViewSites.SelectedImageIndex = -1，这会导致节点选中时默认不显示图标。如果希望选中时和未选中时显示同一图标，需要：

• 给每个节点的SelectedImageIndex设置和ImageIndex相同的值
• 或者把TreeViewSites.SelectedImageIndex改为有效的索引（比如0，对应EMPTY图标）

2. 展开节点时强制刷新 #

在节点展开事件（比如AfterExpand）中设置ImageIndex后，需要调用TreeNode.Refresh()强制节点重绘，否则控件可能不会立即更新显示：

private void TreeViewSites_AfterExpand(object sender, TreeViewEventArgs e)
{
    e.Node.ImageIndex = 1; // 示例：设置为MIXED图标
    e.Node.Refresh();
}

3. 确保图片资源被正确持有 #

直接使用Resources.XXX添加到ImageList时，每次访问都会创建新的图片实例，可能因GC回收导致图片失效。建议先将图片保存到局部变量再添加：

// 先缓存资源图片
var emptyImg = Resources.EMPTY;
var mixedImg = Resources.MIXED;
var downImg = Resources.DOWN;
var upImg = Resources.UP;

// 再添加到ImageList
mlstImg.Images.Add(emptyImg);
mlstImg.Images.Add(mixedImg);
mlstImg.Images.Add(downImg);
mlstImg.Images.Add(upImg);

4. 触发控件重绘 #

如果修改ImageIndex后仍不显示，可手动调用TreeView.Invalidate()或TreeNode.Invalidate()触发重绘，确保控件更新：

// 修改节点ImageIndex后
treeNode.ImageIndex = 2;
treeNode.Invalidate();
// 或者刷新整个TreeView
TreeViewSites.Invalidate();

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