将 NSAccessibilityElement 添加到现有的 NSView

Question

我想将MacOS accessibility feature 与我的应用程序一起使用，该应用程序呈现自己的自定义 UI（即不使用 Cocoa）。为此，我实现了与我绘制的每个小部件相关联的子类NSAccessibilityElements 树。 根 UI 容器托管在外部提供给我的应用程序的 NSView 内（我的应用程序是一个插件）。现在我需要将我的NSAccessibilityElements 树附加到主机提供的现有NSView。

Apple documentation 推荐两种方法来实现这一点：

• 重新实现父级的accessibilityChildren 属性以包含自定义元素（例如Qt 使用此方法）。不幸的是，我自己没有创建父 NSView，它是从外部注入的。
• 调用accessibilityAddChildElement便捷方法。但是当我在提供的NSView 对象上调用它时，我得到一个异常，它不响应此方法。

将NSAccessibilityElements 树附加到现有NSView 的正确方法是什么？

Answer 1

所以我最终将NSView 子类化以捕获顶级NSAccessibilityElement。重写的- (NSArray*) accessibilityChildren 方法将捕获的可访问性元素作为其子元素之一返回：

@interface AccessibilityRootView : NSView
- (instancetype)initWithAccessibilityElement: (NSAccessibilityElement*)anElement;
@end

@implementation AccessibilityRootView
{
    NSAccessibilityElement* element;
}

- (instancetype) initWithAccessibilityElement: (NSAccessibilityElement*)anElement
{
    self = [super init];

    if (self)
        element = anElement;

    return self;
}

- (NSArray*) accessibilityChildren
{
    NSArray<NSAccessibilityElement*> *children = [super accessibilityChildren];

    int numKids = (int)[children count] + 1;
    NSMutableArray<NSAccessibilityElement*> *kids = [NSMutableArray<NSAccessibilityElement*> arrayWithCapacity:numKids];

    for (id object in children)
        [kids addObject:object];

    [kids addObject: element];

    return NSAccessibilityUnignoredChildren (kids);
}
@end

然后我将这个大小为零的子类视图附加到主机提供的父 NSView：

NSView* hostView = /* host-provided NSView */;
AccessibilityRootView* accessibilityRootView = [[AccessibilityRootView alloc] initWithAccessibilityElement:(NSAccessibilityElement*)topLevelAccessibilityElement];
[hostView addSubview:accessibilityRootView];
[accessibilityRootView release];

此时我所有的NSAccessibilityElements 都附加到主机提供的视图中的零大小视图，MacOS 可以成功查询这些项目。

此外，每个NSAccessibilityElement 都必须正确实施其 - (NSRect)accessibilityFrame 和 - (id) accessibilityHitTest:(NSPoint)point 以匹配我自定义绘制的 UI 小部件的屏幕位置。