Visual UI Automation Verify中WPF上下文菜单显示DisconnectedItem问题

这问题我之前做WPF自动化测试时也碰过类似的坑，动态上下文菜单在UIA工具里显示DisconnectedItem的核心原因，和WPF上下文菜单的生命周期以及UIA框架的元素跟踪逻辑有关，咱们一步步来拆解解决：

为什么会出现DisconnectedItem？ #

WPF的ContextMenu默认是弹出式临时元素，关闭后会被从可视化树中卸载销毁；再加上你每次打开菜单时都会清空并重建SelectedItemContextMenuItemCollection，旧的菜单项实例会被彻底丢弃，UIA框架自然会失去对这些元素的引用，所以工具里会显示DisconnectedItem。而硬编码的菜单不会被销毁重建，UIA能一直跟踪到元素，所以没问题。

能不能用Visual UI Automation Verify测试这种动态菜单？ #

当然可以，但需要调整你的实现方式，让UIA框架能持续跟踪到动态变化的菜单项，或者在合适的时机捕获元素。

具体解决思路和方案 #

1. 避免销毁重建菜单项集合，改用集合更新

不要每次打开菜单时都Clear()再重新Add新项，而是用ObservableCollection<你的菜单项VM>作为集合类型，通过增删现有项来更新菜单，而不是替换整个集合或清空重建。这样UIA框架能接收到集合变化的通知，保持对元素的引用。

比如把原来的逻辑：

SelectedItemContextMenuItemCollection.Clear();
foreach (var item in newMenuItems)
{
    SelectedItemContextMenuItemCollection.Add(item);
}

改成：

// 先移除不需要的项
var itemsToRemove = SelectedItemContextMenuItemCollection.Where(oldItem => !newMenuItems.Any(newItem => newItem.Id == oldItem.Id)).ToList();
foreach (var item in itemsToRemove)
{
    SelectedItemContextMenuItemCollection.Remove(item);
}
// 再添加新项
var itemsToAdd = newMenuItems.Where(newItem => !SelectedItemContextMenuItemCollection.Any(oldItem => oldItem.Id == newItem.Id)).ToList();
foreach (var item in itemsToAdd)
{
    SelectedItemContextMenuItemCollection.Add(item);
}
// 必要时更新现有项的属性
foreach (var existingItem in SelectedItemContextMenuItemCollection)
{
    var matchingNewItem = newMenuItems.FirstOrDefault(n => n.Id == existingItem.Id);
    if (matchingNewItem != null)
    {
        existingItem.Header = matchingNewItem.Header;
        existingItem.Command = matchingNewItem.Command;
        // 其他属性更新
    }
}

2. 确保UIA能识别菜单项的文本

给你的MenuItem显式绑定AutomationProperties.Name，这样即使DataContext有变化，UIA工具也能正确读取菜单项标题：

<MenuItem AutomationProperties.Name="{Binding Header}"
          Header="{Binding Header}"
          Command="{Binding Command}" />

3. 在菜单打开状态下捕获UIA元素

UIA工具（包括Inspect.exe和Visual UI Automation Verify）只能跟踪当前存在于可视化树中的元素，所以测试时要确保在菜单打开的状态下捕获元素，不要在关闭后再去检查。你可以在ContextMenuOpening命令执行完成、菜单显示后，暂停测试流程，手动或自动触发UIA工具的元素捕获。

4. 简化绑定逻辑，减少代理依赖

你的绑定代理虽然解决了上下文菜单不在可视化树的DataContext问题，但增加了UIA跟踪的复杂度。可以尝试在ContextMenuOpening事件中，直接把TreeList的选中项赋值给ContextMenu的DataContext：

// 在ContextMenuOpeningCommand中
var selectedItem = YourTreeList.SelectedItem;
TreeListContextMenu.DataContext = selectedItem;
// 然后菜单项的ItemsSource可以直接绑定到选中项的ContextMenuItemCollection

这样减少了一层代理绑定，让UIA更容易跟踪元素的DataContext。

5. 改用DevExpress自带的动态菜单机制

DevExpress的TreeList有专门的TreeListView.PopupMenuShowing事件和TreeListControl.ContextMenuCustomizations属性，用来处理动态上下文菜单，这些内置机制已经考虑了UIA兼容性问题，比自定义绑定代理更稳定。比如：

private void TreeListView_PopupMenuShowing(object sender, PopupMenuShowingEventArgs e)
{
    var selectedItem = e.TreeListView.SelectedItem as YourDataType;
    e.Menu.Items.Clear();
    // 根据选中项属性添加菜单项
    if (selectedItem.IsTypeA)
    {
        e.Menu.Items.Add(new BarButtonItem { Content = "操作A", Command = YourCommandA });
    }
    else if (selectedItem.IsTypeB)
    {
        e.Menu.Items.Add(new BarButtonItem { Content = "操作B", Command = YourCommandB });
    }
}

总结 #

核心思路就是尽量让菜单项实例保持稳定，避免频繁销毁重建，同时确保UIA能在菜单打开时捕获到有效元素。按照上面的方案调整后，应该就能在Visual UI Automation Verify中正常测试动态上下文菜单了。

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