sgcUI 的无障碍

每个 sgcUI 产品都向 Microsoft UI Automation 公开其内容(Narrator 和 NVDA 等屏幕阅读器使用的正是这一 API),可以用键盘操作(已知限制中列出的例外除外),并遵循 Windows 高对比度主题。本页说明我们的承诺、涵盖的范围、尚未涵盖的内容,并链接各平台的符合性报告。

我们的承诺

eSeGeCe 构建 sgcUI,是为了让用它制作的应用程序可以被所有人使用,包括使用屏幕阅读器的人、只使用键盘的人以及需要强对比度的人。无障碍支持是每个产品、每个版本的一部分,包括免费的社区版,并且默认开启:把控件放到窗体上,它就是无障碍的,无需任何设置,在没有无障碍客户端运行时也没有额外开销。

这项支持按照 EN 301 549 和 WCAG 2.1 AA 级中适用于软件组件的要求设计:每个元素的名称、角色、值和状态,键盘操作,可见的焦点,非文本对比度,以及系统颜色的使用。我们为每个平台发布一份无障碍符合性报告,并在组件变化时更新。

您的应用程序最终的符合性还取决于您如何使用这些组件:为每个控件设置有意义的名称,在窗体上保持合理的 Tab 顺序,并且不要在您显示的数据中仅靠颜色传达信息。

涵盖的内容

sgcGrid、sgcPivotGrid、sgcCharts、sgcGauges、sgcDashboard、sgcPlanner、sgcDiagram、sgcWizard、sgcNavigation、sgcToolbar、sgcEditors 和 sgcMaps。

组件向 Microsoft UI Automation 公开其内容。这是 Windows 的无障碍接口,Narrator 和 NVDA 等屏幕阅读器以及 Microsoft 的测试工具都使用它:网格作为带有行、单元格和标题的表格公开,图表作为系列和数据点的列表,规划器作为项目的列表,依此类推。只支持 MSAA 的旧客户端通过 Windows 在 UI Automation 与 MSAA 之间提供的桥接获得服务。

  • VCL:在每个受支持的 Delphi 和 C++Builder 版本(从 Delphi 7 到 Delphi 13,以及从 C++Builder 2007 到 C++Builder 13)中提供 UI Automation,只有一条代码路径,各版本行为相同。
  • FireMonkey:在 Windows 上提供 UI Automation。窗体是根,窗体上的每个 sgcUI 控件都是其中的一个元素。
  • WinForms:每个控件提供自己的 UI Automation 提供程序,因此网格是具有 Grid 和 Table 模式的表格。支持 .NET Framework 4.7.2 以及 .NET 8、9 和 10。
  • WPF:每个控件返回一个自动化对等体,并为其绘制的每个项目返回一个对等体。支持 .NET Framework 4.7.2 以及 .NET 8、9 和 10。
  • Avalonia 12(12.0 或更高版本,已使用 12.1.4 测试):每个控件返回一个自动化对等体,并为其绘制的每个项目返回一个对等体,在 Windows 上传给 UI Automation。支持 .NET 8、9 和 10。
  • sgcMaps 在 VCL、Windows 上的 FireMonkey 和 WinForms 上可访问,这些是它可用的平台。
  • 键盘:移动和调整磁贴、规划器项目和形状的大小,移动看板卡片,创建甘特图依赖关系和图表连接线,从面板添加形状,以及移动数据透视字段和网格列,都有键盘替代方式。每个交互式控件都显示可见的焦点环。
  • 当控件使用默认主题时,会自动遵循 Windows 高对比度,utHighContrast 主题则强制启用它。支持从右到左的布局和高 DPI。

未涵盖的内容

  • sgcPDF 查看器控件和 sgcReports 预览控件在此版本中不公开无障碍信息。sgcPDF 和 sgcReports 生成的 PDF 文件可以是带标签的 PDF/UA 文档,这是文档功能,不在报告的评估范围内。
  • macOS、iOS 和 Android 上的 FireMonkey:无障碍层目前仅在 Windows 上可用。
  • Avalonia 仅在 Windows 上评估过,其他操作系统未评估。

符合性状态

符合性报告遵循 VPAT 2.5 国际版,涵盖 WCAG 2.1 A 级和 AA 级、修订后的 Section 508 标准以及 EN 301 549 V3.2.1(2021-03)。大多数标准项得到支持,部分得到部分支持,每一行的备注说明了组件提供什么,以及哪些属于应用程序开发人员的责任。

这些报告基于按产品逐个对实现与其设计所做的审查、各产品 QA 套件中的进程内自动化测试(名称、角色、值、状态、模式、元素树、从右到左布局下以及 100% 到 200% DPI 下的边界、键盘替代方式、焦点指示器、高对比度渲染,以及没有客户端监听时零开销的规则),以及对主题颜色对比度的实测。

我们在所有平台(Delphi VCL、C++Builder、Windows 上的 FireMonkey、.NET WinForms、WPF 和 Avalonia)上使用屏幕阅读器 NVDA 2026.2 测试了这些组件。我们还使用 Accessibility Insights for Windows 和 AxeWindows 2.4.2 进行了扫描,并修复了发现的所有真实缺陷。Narrator 未经测试。一致性报告列出了每项标准的结果。

已知限制

如符合性报告所述。

  • sgcGrid 的列宽调整、sgcCharts 的鼠标缩放和平移以及金融绘图工具,还有 sgcDiagram 的连接线折点,目前还没有键盘替代方式。应用程序可以通过组件 API 提供这些功能。
  • 默认主题:组件边框为 1.5:1(浅色),网格线为 1.2:1(浅色)和 1.3:1(深色),八种浅色系列颜色中有四种在白色背景上低于 3:1,当产品用于文本时,浅色强调色在白色背景上为 4.4:1。高对比度主题满足对比度标准,开发人员也可以自行选择颜色。
  • 在默认的浅色和深色主题中,图表系列、规划器类别和网格格式规则靠颜色区分,除非开发人员添加标记、虚线样式、数据标签或文字。同样的信息始终会以文本形式公开给辅助技术。
  • 图表工具提示和十字光标标签跟随指针或焦点数据点,无法悬停。它们的值也作为焦点数据点的值公开。
  • 未实现 UI Automation 的 Text 模式(编辑器和图示标签中的文本属性、插入符和选择)。文本作为名称和值公开,VCL 文本编辑器嵌入了一个公开自身文本的原生编辑控件。
  • 未公开与单独标签控件的 LabeledBy 关系。请改为设置控件的无障碍名称。
  • 只有当应用程序把系统文本大小设置映射到组件的字体时,才会应用该设置。
  • sgcMaps:地图图像仅用其中心和缩放级别来描述,并且地图渲染器不遵循高对比度,因为地图图像是提供商的瓦片图像。
  • 打印和 PDF 导出的替代文本来自与默认无障碍说明相同的生成器。应用程序设置的无障碍说明不会被导出使用。
  • Avalonia 12 没有 Grid 和 Table 模式,因此 sgcGrid 和 sgcPivotGrid 在每个单元格的名称和帮助文本中给出列标题和位置,而不是表格关系。使用 NVDA 还发现了 Avalonia 的两项限制。在 NVDA 默认(选择性)的 UI Automation 事件注册下,sgcUI 控件内部项目的状态变化不会被播报,因为 Avalonia 窗口对 GetFocusedElement 返回的是控件而不是项目。Avalonia 也没有 UI Automation 通知事件,因此 Avalonia 不会播报实时通知。解决办法:在 NVDA 中打开设置、高级,并将 "Registration for UI Automation events and property changes" 设为 Global。之后项目的状态变化会被播报,实时通知仍不会。
  • 帮助以带有标题和替代文本的 HTML 页面、CHM 和 PDF 形式发布,尚未按 WCAG 2.1 AA 进行审核。

无障碍符合性报告

每个平台一份报告,VPAT 2.5 国际版,2026 年 10 月。可以作为网页阅读,也可以下载 PDF。报告和 PDF 仅提供英文版。

报告平台网页PDF
适用于 Delphi VCL 的 sgcUIDelphi 7 到 Delphi 13 以及 C++Builder 2007 到 C++Builder 13,Windows 上的 VCL 应用程序(Win32 和 Win64)。阅读报告(英文)下载 PDF(英文)
适用于 Delphi FireMonkey(Windows)的 sgcUIWindows 上的 Delphi FireMonkey 应用程序(Win32 和 Win64)。不涵盖 macOS、iOS 和 Android 上的 FireMonkey。阅读报告(英文)下载 PDF(英文)
适用于 .NET WinForms 的 sgcUIWindows 上的 .NET WinForms 应用程序:.NET Framework 4.7.2 及更高版本、.NET 8、.NET 9 和 .NET 10。阅读报告(英文)下载 PDF(英文)
适用于 .NET WPF 的 sgcUIWindows 上的 .NET WPF 应用程序:.NET Framework 4.7.2 及更高版本、.NET 8、.NET 9 和 .NET 10。阅读报告(英文)下载 PDF(英文)
适用于 .NET Avalonia 的 sgcUI.NET 8 或更高版本上的 Avalonia 12 应用程序,在 Windows 上评估。阅读报告(英文)下载 PDF(英文)

联系我们

如果某个控件在您的屏幕阅读器、键盘或对比度设置下难以使用,或者您需要其他格式的报告,请写信至 info@esegece.com。请告诉我们产品、平台、版本以及您使用的辅助技术,我们会进行调查。

本声明编写于 2026 年 10 月,适用于 sgcUI 2026.10。Avalonia 的结果已于 2026 年 10 月 12 日使用 Avalonia 12.1.4 重新测试。

阅读无障碍帮助主题

超值之选:All-AccesseSeGeCe 全部产品,含高级支持,每年 €1,059 起。
查看 All-Access 价格