AXPlatformNodeCocoa(Private) Category Reference

Instance Methods
(NSString *)	- getStringAttribute:
(NSString *)	- getAXValueAsString
(std::unique_ptr< AnnouncementSpec >)	- announcementForEvent:
(void)	- scheduleLiveRegionAnnouncement:

Detailed Description

Definition at line 341 of file ax_platform_node_mac.mm.

Method Documentation

announcementForEvent:

- (unique_ptr< AnnouncementSpec > AXPlatformNodeCocoa(Private)):

(ax::mojom::Event)

eventType

Extends class AXPlatformNodeCocoa.

Definition at line 359 of file ax_platform_node_mac.mm.

                                                       :(ax::mojom::Event)eventType {
  // Only alerts and live region changes should be announced.
  BASE_DCHECK(eventType == ax::mojom::Event::kAlert ||
              eventType == ax::mojom::Event::kLiveRegionChanged);
  std::string liveStatus = _node->GetStringAttribute(ax::mojom::StringAttribute::kLiveStatus);
  // If live status is explicitly set to off, don't announce.
  if (liveStatus == "off")
    return nullptr;
 
  NSString* name = [self getName];
  NSString* announcementText = name;
  if ([announcementText length] <= 0) {
    announcementText = @(base::UTF16ToUTF8(_node->GetInnerText()).data());
  }
  if ([announcementText length] == 0)
    return nullptr;
 
  auto announcement = std::make_unique<AnnouncementSpec>();
  announcement->announcement = base::scoped_nsobject<NSString>([announcementText retain]);
  announcement->window = base::scoped_nsobject<NSWindow>([[self AXWindowInternal] retain]);
  announcement->is_polite = liveStatus != "assertive";
  return announcement;
}

getAXValueAsString

- (NSString *) getAXValueAsString

Extends class AXPlatformNodeCocoa.

Definition at line 359 of file ax_platform_node_mac.mm.

                                {
  id value = [self AXValueInternal];
  return [value isKindOfClass:[NSString class]] ? value : nil;
}

getStringAttribute:

- (NSString *) getStringAttribute:

(ax::mojom::StringAttribute)

attribute

Extends class AXPlatformNodeCocoa.

Definition at line 359 of file ax_platform_node_mac.mm.

                               :(ax::mojom::StringAttribute)attribute {
  std::string attributeValue;
  if (_node->GetStringAttribute(attribute, &attributeValue))
    return @(attributeValue.data());
  return nil;
}

scheduleLiveRegionAnnouncement:

- (void) scheduleLiveRegionAnnouncement:

(std::unique_ptr< AnnouncementSpec >)

announcement

Extends class AXPlatformNodeCocoa.

Definition at line 359 of file ax_platform_node_mac.mm.

                                      :(std::unique_ptr<AnnouncementSpec>)announcement {
  if (_pendingAnnouncement) {
    // An announcement is already in flight, so just reset the contents. This is
    // threadsafe because the dispatch is on the main queue.
    _pendingAnnouncement = std::move(announcement);
    return;
  }
 
  _pendingAnnouncement = std::move(announcement);
  dispatch_after(kLiveRegionDebounceMillis * NSEC_PER_MSEC, dispatch_get_main_queue(), ^{
    if (!_pendingAnnouncement) {
      return;
    }
    PostAnnouncementNotification(_pendingAnnouncement->announcement, _pendingAnnouncement->window,
                                 _pendingAnnouncement->is_polite);
    _pendingAnnouncement.reset();
  });
}

---

The documentation for this category was generated from the following file:

• third_party/accessibility/ax/platform/ax_platform_node_mac.mm