Files
zimoyin 529f7910a1 新增跨来源取值键「文本内容」,修好富文本/输入框读不到内容
问题:富文本(RichTextBox、Chromium/CEF、UWP 文本框)的 UIA Name 往往是通用标题
(实测夹具里是 "RichEdit Control"),真正的内容只在 ValuePattern/TextPattern 里;
而新增监控项时默认 ValueKey 是 Name,于是读回来的是标题而不是内容。

- ControlValueKeys 新增跨来源键「文本内容」:UIA 按 Value → Text → Name 顺序取,
  MSAA = accValue → accName,Win32 = 窗口标题;三种都取不到才报错并说明各自原因
- 新增/拾取控件时默认 ValueKey 改为「文本内容」(旧条目不受影响,仍按各自保存的键读)
- 「文本内容」加进三个来源的可选键列表,监控列表下拉里能直接选
- 夹具新增多行富文本 FixtureRichText(内容只在 Value/Text 里)
- 回归新增 ValueKeyTests(键表、Name 兜底、默认键),共 27/27 通过

实测(跨进程,目标为独立进程里的夹具窗口):
- 文本框 文本内容="可编辑文本";富文本 文本内容="富文本第一行\r富文本第二行\r";
  按钮(无 Value/Text 模式)自动退回 Name="测试按钮"
- 拾取点在两个控件上都精确命中 Edit / Document,且能在窗口树里找到同一节点
- 无界面读取端到端:2 条配置(//Document[...]、//Edit[...] + 文本内容)全部命中并取到值
2026-10-13 16:22:03 +08:00

216 lines
12 KiB
C#
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// =====================================================================================
// pacs_win_uia 回归测试工程(net48 控制台程序,AssemblyName = RegressionTests)。
//
// 覆盖范围:
// - XPath 定位的解析 / 生成 / 转义 / 歧义与拒绝 ................ PathTests
// - 监控条目与设置的持久化、旧格式迁移、缺省值 ................ PersistenceTests
// - 控件树增量刷新时的节点身份保持 ............................ TreeRefreshTests
// - 悬浮条显示条件的窗口匹配与配置校验 ........................ FloatingConditionsTests
// - 悬浮条进程/类名/标题下拉的原生鼠标与键盘选择 .............. SettingsComboBoxTests
// - 遮挡诊断里“本工具自身窗口不算遮挡” ........................ WindowVisibilityTests
//
// 为什么这样测(重要):
// 用例都在**纯内存快照**(ControlTreeNode)或本进程自建的 WinForms 控件上运行,
// 绝不调用 UIA 去读本进程自己的控件树——UIA 自读会导致进程崩溃(见 MEMORY:
// in-process UIA self-reads segfault)。凡是必须走真实 UIA 的场景,请改用
// tests/uia-fixture 的独立进程做跨进程验证,不要在这里自读。
//
// 新增用例加在哪里:
// 按主题加到对应 *Tests.cs 的 Register(...) 列表里,并在该文件里实现一个
// private static void 方法;断言统一走 Check.*,不要自己 throw 或手写 Console 判断。
//
// Register 模式怎么用:
// 每个测试类提供 static Register(IList<KeyValuePair<string, Action>>),
// 把「用例名 → 委托」成对登记;Main 依次调用它们收集全部用例,再逐个执行并统计。
// =====================================================================================
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using pacs_win_uia.Models;
using pacs_win_uia.Services;
namespace PacsWinUia.RegressionTests
{
internal static class Program
{
// 运行方式:不要在本目录直接 dotnet build(src 的 bin\Debug 可能被正在运行的工具进程锁定)。
// 用一个隔离的 OutputPath 构建,再直接运行生成的 exe:
// dotnet msbuild tests\regression\RegressionTests.csproj -t:Build -p:Configuration=Debug
// -p:OutputPath=<隔离目录>\ -v:minimal
// <隔离目录>\RegressionTests.exe
// 退出码:0 = 全部用例通过;1 = 有任一用例失败(见 Main 末尾的 return)。
[STAThread]
private static int Main()
{
Console.OutputEncoding = new UTF8Encoding(false);
var tests = new List<KeyValuePair<string, Action>>();
// 各测试类把自己的用例登记进同一张表(顺序即执行顺序,彼此独立无共享状态)。
PathTests.Register(tests);
PersistenceTests.Register(tests);
TreeRefreshTests.Register(tests);
FloatingConditionsTests.Register(tests);
SettingsComboBoxTests.Register(tests);
WindowVisibilityTests.Register(tests);
ValueKeyTests.Register(tests);
int passed = 0;
// 逐个执行登记的用例:通过则 PASS 并累加,抛异常则 FAIL 并打印完整异常。
foreach (var test in tests)
{
try
{
test.Value();
passed++;
Console.WriteLine("PASS " + test.Key);
}
catch (Exception exception)
{
Console.WriteLine("FAIL " + test.Key);
Console.WriteLine(exception);
}
}
Console.WriteLine("RESULT total={0} passed={1} failed={2}", tests.Count, passed, tests.Count - passed);
// 退出码约定:0 = 全部通过,1 = 存在失败(供 CI / 脚本判断)。
return passed == tests.Count ? 0 : 1;
}
}
// Check —— 断言助手:所有用例统一用它抛 InvalidOperationException 表示失败,
// 失败信息里带上用例内传入的 message,便于定位。
internal static class Check
{
// 条件必须为真;否则以 message 抛异常。
public static void True(bool condition, string message)
{
if (!condition) throw new InvalidOperationException(message);
}
// 断言值相等(用默认相等比较器);失败时附带 expected/actual。
public static void Equal<T>(T expected, T actual, string message)
{
True(EqualityComparer<T>.Default.Equals(expected, actual),
message + "; expected=" + expected + "; actual=" + actual);
}
// 断言引用相同(节点必须还是原来那个对象,防止树刷新时被重建)。
public static void Same(object expected, object actual, string message)
{
True(ReferenceEquals(expected, actual), message + "; node reference mismatch");
}
// 断言 path 在 root 上按顺序解析到给定节点;唯一命中时额外校验 SelectUnique 也一致。
public static void Matches(ControlTreeNode root, string path, params ControlTreeNode[] expected)
{
string error;
IList<ControlTreeNode> actual = ControlPath.Select(root, path, out error);
Equal<string>(null, error, "Select error: " + path);
Equal(expected.Length, actual.Count, "Select count: " + path);
for (int i = 0; i < expected.Length; i++) Same(expected[i], actual[i], "Select order: " + path);
if (expected.Length == 1)
{
Same(expected[0], ControlPath.SelectUnique(root, path, out error), "SelectUnique: " + path);
Equal<string>(null, error, "SelectUnique error: " + path);
}
}
// 断言 path 被拒绝:Select 返回空、SelectUnique 返回 null,且都带非空错误信息。
public static void Rejected(ControlTreeNode root, string path)
{
string error;
Equal(0, ControlPath.Select(root, path, out error).Count, "Rejected path returned nodes: " + path);
True(!string.IsNullOrWhiteSpace(error), "Rejected path lacks error: " + path);
Equal<ControlTreeNode>(null, ControlPath.SelectUnique(root, path, out error), "Rejected path uniquely resolved: " + path);
True(!string.IsNullOrWhiteSpace(error), "Rejected unique path lacks error: " + path);
}
}
// 每个持久化用例独占一个临时目录,Dispose 时递归删除;不碰真实用户配置目录。
internal sealed class TemporaryDirectory : IDisposable
{
public TemporaryDirectory()
{
DirectoryPath = Path.Combine(Path.GetTempPath(), "pacs-win-uia-regression-" + Guid.NewGuid().ToString("N"));
Directory.CreateDirectory(DirectoryPath);
}
public string DirectoryPath { get; private set; }
public string File(string name) { return Path.Combine(DirectoryPath, name); }
public void Dispose() { Directory.Delete(DirectoryPath, true); }
}
// Every node is an in-memory snapshot: no AutomationElement, HWND lookup, GUI or provider calls.
//
// TreeFixture —— 供 XPath 用例复用的纯内存控件树夹具,结构:
// Window(设置, RootClass)
// ├─ Custom(PermanentNavigationView)
// │ ├─ Group(...BreadcrumbBar) > Button(个性化) > Text(个性化) → BreadcrumbText
// │ └─ Window(PaneRoot) > Pane(MenuItemsScrollViewer) > Group(MenuItemsHost)
// │ └─ ListItem(个性化) → MenuItem
// ├─ Group(Duplicates):重复 AutomationId、同名异类型、有无 Id、无名字等边界节点
// └─ Text/Edit:中文、单双引号、斜杠、> < & [ ] 等转义样本
// Node(...) 造节点、Add(...) 挂子节点、All(...) 深度优先枚举,供 roundtrip/改名校验遍历全树。
internal sealed class TreeFixture
{
public const string BreadcrumbLegacy = "[Uia] Custom[PermanentNavigationView] > Group[PermanentNavigationViewBreadcrumbBar] > Button:个性化 > Text:个性化";
public const string MenuLegacy = "[Uia] Window:设置 > Custom[PermanentNavigationView] > Window[PaneRoot] > Pane[MenuItemsScrollViewer] > Group[MenuItemsHost] > ListItem:个性化";
public readonly ControlTreeNode Root;
public readonly ControlTreeNode Navigation;
public readonly ControlTreeNode BreadcrumbText;
public readonly ControlTreeNode MenuItem;
public readonly ControlTreeNode Duplicates;
public readonly ControlTreeNode FirstDuplicate;
public readonly ControlTreeNode SecondDuplicate;
public readonly ControlTreeNode NameWithId;
public readonly ControlTreeNode NameWithoutId;
public readonly ControlTreeNode Nameless;
public readonly ControlTreeNode EscapedName;
public readonly ControlTreeNode EscapedId;
public TreeFixture()
{
Root = Node("Window", "设置", null, "RootClass");
Navigation = Add(Root, Node("Custom", null, "PermanentNavigationView"));
var breadcrumb = Add(Navigation, Node("Group", null, "PermanentNavigationViewBreadcrumbBar"));
BreadcrumbText = Add(Add(breadcrumb, Node("Button", "个性化")), Node("Text", "个性化"));
var paneRoot = Add(Navigation, Node("Window", null, "PaneRoot"));
var scroll = Add(paneRoot, Node("Pane", null, "MenuItemsScrollViewer"));
var host = Add(scroll, Node("Group", null, "MenuItemsHost"));
MenuItem = Add(host, Node("ListItem", "个性化"));
Add(host, Node("ListItem", "系统"));
Duplicates = Add(Root, Node("Group", null, "Duplicates"));
FirstDuplicate = Add(Duplicates, Node("Button", "重复", "same-id", "PrimaryButton"));
Add(Duplicates, Node("Text", "同级异类型"));
Add(Duplicates, Node("Button", "其他", "other-id", "OtherButton"));
SecondDuplicate = Add(Duplicates, Node("Button", "重复", "same-id", "SecondaryButton"));
NameWithId = Add(Duplicates, Node("Button", "混合名称", "has-id"));
NameWithoutId = Add(Duplicates, Node("Button", "混合名称"));
Nameless = Add(Duplicates, Node("Button"));
Add(Duplicates, Node("Button"));
EscapedName = Add(Root, Node("Text", "中文 '单引号' \"双引号\" /斜杠 > 大于 & < [括号]"));
EscapedId = Add(Root, Node("Edit", "输入", "id'\"/ > 中文 & <", "class'\"/ > 中文 & <"));
}
public static ControlTreeNode Node(string type, string name = null, string id = null, string className = null)
{
return new ControlTreeNode
{
Source = ControlTreeSource.Uia,
Uia = new UiaElementInfo { ControlType = "ControlType." + type, Name = name, AutomationId = id, ClassName = className }
};
}
public static ControlTreeNode Add(ControlTreeNode parent, ControlTreeNode child)
{
parent.Children.Add(child);
return child;
}
public static IEnumerable<ControlTreeNode> All(ControlTreeNode root)
{
yield return root;
foreach (ControlTreeNode child in root.Children)
foreach (ControlTreeNode descendant in All(child)) yield return descendant;
}
}
}