Support IAccessibleHypertext.

content/browser/accessibility/browser_accessibility_win.h

 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_WIN_H_
 #define CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_WIN_H_
 #pragma once
 
 #include <atlbase.h>
 #include <atlcom.h>
@@ skipping 22 matching lines @@
 // communication of accessibility information, providing accessibility
 // to be used by screen readers and other assistive technology (AT).
 //
 ////////////////////////////////////////////////////////////////////////////////
 class __declspec(uuid("562072fe-3390-43b1-9e2c-dd4118f5ac79"))
 BrowserAccessibilityWin
     : public BrowserAccessibility,
       public CComObjectRootEx<CComMultiThreadModel>,
       public IDispatchImpl<IAccessible2, &IID_IAccessible2,
                            &LIBID_IAccessible2Lib>,
+      public IAccessibleHyperlink,

[dmazzoni, 2011/11/01 05:08:34]

Add IAccessibleAction here?

[David Tseng, 2011/11/01 19:38:04]

IAccessibleHyperlink : IAccessibleAction

+      public IAccessibleHypertext,
       public IAccessibleImage,
       public IAccessibleTable,
       public IAccessibleTable2,
       public IAccessibleTableCell,
-      public IAccessibleText,
       public IAccessibleValue,
       public IServiceProvider,
       public ISimpleDOMDocument,
       public ISimpleDOMNode,
       public ISimpleDOMText {
  public:
   BEGIN_COM_MAP(BrowserAccessibilityWin)
     COM_INTERFACE_ENTRY2(IDispatch, IAccessible2)
     COM_INTERFACE_ENTRY2(IAccessible, IAccessible2)
+    COM_INTERFACE_ENTRY2(IAccessibleText, IAccessibleHypertext)
     COM_INTERFACE_ENTRY(IAccessible2)
+    COM_INTERFACE_ENTRY(IAccessibleHyperlink)
+    COM_INTERFACE_ENTRY(IAccessibleHypertext)
     COM_INTERFACE_ENTRY(IAccessibleImage)
     COM_INTERFACE_ENTRY(IAccessibleTable)
     COM_INTERFACE_ENTRY(IAccessibleTable2)
     COM_INTERFACE_ENTRY(IAccessibleTableCell)
-    COM_INTERFACE_ENTRY(IAccessibleText)
     COM_INTERFACE_ENTRY(IAccessibleValue)
     COM_INTERFACE_ENTRY(IServiceProvider)
     COM_INTERFACE_ENTRY(ISimpleDOMDocument)
     COM_INTERFACE_ENTRY(ISimpleDOMNode)
     COM_INTERFACE_ENTRY(ISimpleDOMText)
   END_COM_MAP()
 
+  // Represents a non-static text node in IAccessibleHypertext.

[dmazzoni, 2011/11/01 05:08:34]

Add a tiny bit more detail so someone new to this understands what's going on -
say something like: this character is embedded in the response to
IAccessibleText's get_text interface, indicating the position where a child
object appears.

[David Tseng, 2011/11/01 19:38:04]

Done.

+  static const char16 kEmbeddedCharacter[];
+
   CONTENT_EXPORT BrowserAccessibilityWin();
 
   CONTENT_EXPORT virtual ~BrowserAccessibilityWin();
 
   //
   // BrowserAccessibility methods.
   //
   CONTENT_EXPORT virtual void Initialize();
   CONTENT_EXPORT virtual void SendNodeUpdateEvents();
   CONTENT_EXPORT virtual void NativeAddReference();
@@ skipping 391 matching lines @@
     return E_NOTIMPL;
   }
   CONTENT_EXPORT STDMETHODIMP scrollSubstringToPoint(LONG start_index,
       LONG end_index,
       enum IA2CoordinateType coordinate_type,
       LONG x, LONG y) {
     return E_NOTIMPL;
   }
 
   //
+  // IAccessibleHypertext methods.
+  //
+
+  CONTENT_EXPORT STDMETHODIMP get_nHyperlinks(long* hyperlinkCount);

[dmazzoni, 2011/11/01 05:08:34]

Nit: Convert all of the method parameters to hacker style, i.e.
lowercase_with_underscores

[David Tseng, 2011/11/01 19:38:04]

Done.

+
+  CONTENT_EXPORT STDMETHODIMP get_hyperlink(
+      long index,
+      IAccessibleHyperlink** hyperlink);
+
+  CONTENT_EXPORT STDMETHODIMP get_hyperlinkIndex(long char_index,
+      long* hyperlink_index);
+
+  // IAccessibleHyperlink not implemented.
+  CONTENT_EXPORT STDMETHODIMP get_anchor(long index, VARIANT* anchor) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_anchorTarget(
+      long index,
+      VARIANT* anchorTarget) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_startIndex( long* index) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_endIndex( long* index) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_valid(boolean* valid) {
+    return E_NOTIMPL;
+  }
+
+  // IAccessibleAction not implemented.
+  CONTENT_EXPORT STDMETHODIMP nActions(long* nActions) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP doAction(long actionIndex) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_description(
+      long actionIndex,
+      BSTR* description) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_keyBinding(
+      long actionIndex,
+      long nMaxBindings,
+      BSTR** keyBindings,
+      long* nBindings) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_name(long actionIndex, BSTR* name) {
+    return E_NOTIMPL;
+  }
+  CONTENT_EXPORT STDMETHODIMP get_localizedName(
+      long actionIndex,
+      BSTR* localizedName) {
+    return E_NOTIMPL;
+  }
+
+  //
   // IAccessibleValue methods.
   //
 
   CONTENT_EXPORT STDMETHODIMP get_currentValue(VARIANT* value);
 
   CONTENT_EXPORT STDMETHODIMP get_minimumValue(VARIANT* value);
 
   CONTENT_EXPORT STDMETHODIMP get_maximumValue(VARIANT* value);
 
   CONTENT_EXPORT STDMETHODIMP setCurrentValue(VARIANT new_value);
@@ skipping 217 matching lines @@
   string16 previous_text_;
 
   // The old text to return in IAccessibleText::get_oldText - this is like
   // previous_text_ except that it's NOT updated when the object
   // is initialized again but the text doesn't change.
   string16 old_text_;
 
   // Relationships between this node and other nodes.
   std::vector<BrowserAccessibilityRelation*> relations_;
 
+  // The text of this node including embedded hyperlink characters.
+  string16 hypertext_;
+
+  // Maps the |hypertext_| embedded character offset to a child of |children_|.
+  std::map<int32, int32> hyperlink_offset_to_index_;
+
   // Give BrowserAccessibility::Create access to our constructor.
   friend class BrowserAccessibility;
   friend class BrowserAccessibilityRelation;
 
   DISALLOW_COPY_AND_ASSIGN(BrowserAccessibilityWin);
 };
 
 #endif  // CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_WIN_H_