content/browser/accessibility/browser_accessibility_manager_win.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_MANAGER_WIN_H_
   6 #define CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_MANAGER_WIN_H_
   7
   8 #include <oleacc.h>
   9
  10 #include "base/memory/scoped_ptr.h"
  11 #include "base/win/scoped_comptr.h"
  12 #include "content/browser/accessibility/browser_accessibility_manager.h"
  13
  14 namespace content {
  15 class BrowserAccessibilityWin;
  16
  17 class LegacyRenderWidgetHostHWND;
  18
  19 // Manages a tree of BrowserAccessibilityWin objects.
  20 class CONTENT_EXPORT BrowserAccessibilityManagerWin
  21     : public BrowserAccessibilityManager {
  22  public:
  23   BrowserAccessibilityManagerWin(
  24       content::LegacyRenderWidgetHostHWND* accessible_hwnd,
  25       IAccessible* parent_iaccessible,
  26       const ui::AXTreeUpdate& initial_tree,
  27       BrowserAccessibilityDelegate* delegate,
  28       BrowserAccessibilityFactory* factory = new BrowserAccessibilityFactory());
  29
  30   virtual ~BrowserAccessibilityManagerWin();
  31
  32   static ui::AXTreeUpdate GetEmptyDocument();
  33
  34   // Get the closest containing HWND.
  35   HWND parent_hwnd() { return parent_hwnd_; }
  36
  37   // The IAccessible for the parent window.
  38   IAccessible* parent_iaccessible() { return parent_iaccessible_; }
  39   void set_parent_iaccessible(IAccessible* parent_iaccessible) {
  40     parent_iaccessible_ = parent_iaccessible;
  41   }
  42
  43   // Calls NotifyWinEvent if the parent window's IAccessible pointer is known.
  44   void MaybeCallNotifyWinEvent(DWORD event, LONG child_id);
  45
  46   // AXTree methods
  47   virtual void OnNodeWillBeDeleted(ui::AXNode* node) OVERRIDE;
  48   virtual void OnNodeCreated(ui::AXNode* node) OVERRIDE;
  49
  50   // BrowserAccessibilityManager methods
  51   virtual void OnWindowFocused() OVERRIDE;
  52   virtual void OnWindowBlurred() OVERRIDE;
  53   virtual void NotifyAccessibilityEvent(
  54       ui::AXEvent event_type, BrowserAccessibility* node) OVERRIDE;
  55
  56   // Track this object and post a VISIBLE_DATA_CHANGED notification when
  57   // its container scrolls.
  58   // TODO(dmazzoni): remove once http://crbug.com/113483 is fixed.
  59   void TrackScrollingObject(BrowserAccessibilityWin* node);
  60
  61   // Return a pointer to the object corresponding to the given windows-specific
  62   // unique id, does not make a new reference.
  63   BrowserAccessibilityWin* GetFromUniqueIdWin(LONG unique_id_win);
  64
  65   // Called when |accessible_hwnd_| is deleted by its parent.
  66   void OnAccessibleHwndDeleted();
  67
  68  protected:
  69   // BrowserAccessibilityManager methods
  70   virtual void OnRootChanged(ui::AXNode* new_root) OVERRIDE;
  71
  72  private:
  73   // The closest ancestor HWND.
  74   HWND parent_hwnd_;
  75
  76   // The accessibility instance for the parent window.
  77   IAccessible* parent_iaccessible_;
  78
  79   // Give BrowserAccessibilityManager::Create access to our constructor.
  80   friend class BrowserAccessibilityManager;
  81
  82   // Track the most recent object that has been asked to scroll and
  83   // post a notification directly on it when it reaches its destination.
  84   // TODO(dmazzoni): remove once http://crbug.com/113483 is fixed.
  85   BrowserAccessibilityWin* tracked_scroll_object_;
  86
  87   // A mapping from the Windows-specific unique IDs (unique within the
  88   // browser process) to accessibility ids within this page.
  89   base::hash_map<long, int32> unique_id_to_ax_id_map_;
  90
  91   // Owned by its parent; OnAccessibleHwndDeleted gets called upon deletion.
  92   LegacyRenderWidgetHostHWND* accessible_hwnd_;
  93
  94   DISALLOW_COPY_AND_ASSIGN(BrowserAccessibilityManagerWin);
  95 };
  96
  97 }  // namespace content
  98
  99 #endif  // CONTENT_BROWSER_ACCESSIBILITY_BROWSER_ACCESSIBILITY_MANAGER_WIN_H_