如何让屏幕阅读器播报Qt Widgets应用的通知与状态变更？

Qt 提供了无需添加专用UI元素即可触发屏幕阅读器播报状态的方法，核心基于其内置的辅助功能框架：

推荐方案：Qt 5.13+ 使用 QAccessible::announce #

从Qt 5.13开始，QAccessible类新增了announce静态函数，专门用于向屏幕阅读器发送自定义播报消息，无需依赖任何可见UI组件。

代码示例 #

#include <QAccessible>
#include <QApplication>

// 播报任务启动
void notifyTaskStarted(const QString& taskName) {
    const QString announcement = QString("后台任务「%1」已启动").arg(taskName);
    QAccessible::announce(qApp->activeWindow(), announcement);
}

// 播报任务完成
void notifyTaskFinished(const QString& taskName) {
    const QString announcement = QString("后台任务「%1」已完成").arg(taskName);
    QAccessible::announce(qApp->activeWindow(), announcement);
}

第一个参数可传入任意QObject实例（如主窗口、应用对象），屏幕阅读器会识别并播报消息内容。

旧版本兼容方案（Qt 5.12及以下） #

若需兼容更早的Qt版本，可通过发送自定义QAccessibleEvent实现：

代码示例 #

#include <QAccessibleEvent>
#include <QApplication>

void sendAccessibilityAlert(const QString& message) {
    QAccessibleEvent alertEvent(qApp->activeWindow(), QAccessible::Alert);
    alertEvent.setAccessibleName(message);
    QAccessible::updateAccessibility(&alertEvent);
}

// 调用示例
sendAccessibilityAlert("后台数据同步任务已完成");

这种方式利用辅助功能的Alert事件类型，主流屏幕阅读器（如NVDA、VoiceOver、Orca）均会捕捉并播报事件关联的消息。

关键注意事项 #

• 应用辅助功能默认开启：Qt Widgets应用默认启用辅助功能，无需额外配置；若需确认，可确保未禁用Qt::AA_DisableAccessibleWidget属性。
• 平台兼容性：上述方法在Windows（NVDA、JAWS）、macOS（VoiceOver）、Linux（Orca）上均能正常工作，需确保系统层面的辅助功能已启用。

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