summaryrefslogtreecommitdiffstats
path: root/views/accessibility/view_accessibility_wrapper.h
blob: ae4b563f547d410ec3b41a3eb13d2f4daf5c7211 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
// Copyright (c) 2006-2008 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 VIEWS_ACCESSIBILITY_VIEW_ACCESSIBILITY_WRAPPER_H_
#define VIEWS_ACCESSIBILITY_VIEW_ACCESSIBILITY_WRAPPER_H_
#pragma once

#include <atlcomcli.h>
//  Necessary to define OleAcc GUID's used in window_win.cc.
#include <initguid.h>
#include <oleacc.h>

#include "base/basictypes.h"
#include "base/scoped_comptr_win.h"

namespace views {
class View;
}

////////////////////////////////////////////////////////////////////////////////
//
// ViewAccessibilityWrapper
//
// Wrapper class for returning a pointer to the appropriate (platform-specific)
// accessibility interface for a given View. Needed to keep platform-specific
// code out of the View class, when answering calls for child/parent IAccessible
// implementations, for instance.
//
////////////////////////////////////////////////////////////////////////////////
class ViewAccessibilityWrapper {
 public:
  explicit ViewAccessibilityWrapper(views::View* view);
  ~ViewAccessibilityWrapper() {}

  STDMETHODIMP CreateDefaultInstance(REFIID iid);

  HRESULT Uninitialize();

  // Returns a pointer to a specified interface on an object to which a client
  // currently holds an interface pointer. If pointer exists, it is reused,
  // otherwise a new pointer is created. Used by accessibility implementation to
  // retrieve MSAA implementation for child or parent, when navigating MSAA
  // hierarchy.
  STDMETHODIMP GetInstance(REFIID iid, void** interface_ptr);

  // Sets the accessibility interface implementation of this wrapper to be
  // anything the user specifies.
  STDMETHODIMP SetInstance(IAccessible* interface_ptr);

 private:
  // Instance of accessibility information and handling for a View.
  ScopedComPtr<IAccessible> accessibility_info_;

  // View needed to initialize IAccessible.
  views::View* view_;

  DISALLOW_COPY_AND_ASSIGN(ViewAccessibilityWrapper);
};

#endif  // VIEWS_ACCESSIBILITY_VIEW_ACCESSIBILITY_WRAPPER_H_