AccessibilityController.h 3.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. /*
  2. * Copyright (C) 2008, 2009, 2010 Apple Inc. All Rights Reserved.
  3. *
  4. * Redistribution and use in source and binary forms, with or without
  5. * modification, are permitted provided that the following conditions
  6. * are met:
  7. * 1. Redistributions of source code must retain the above copyright
  8. * notice, this list of conditions and the following disclaimer.
  9. * 2. Redistributions in binary form must reproduce the above copyright
  10. * notice, this list of conditions and the following disclaimer in the
  11. * documentation and/or other materials provided with the distribution.
  12. *
  13. * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
  14. * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  16. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR
  17. * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  18. * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  19. * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  20. * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  21. * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  22. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  23. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  24. */
  25. #ifndef AccessibilityController_h
  26. #define AccessibilityController_h
  27. #include "AccessibilityUIElement.h"
  28. #include <JavaScriptCore/JSObjectRef.h>
  29. #include <string>
  30. #include <wtf/HashMap.h>
  31. #include <wtf/Platform.h>
  32. #if PLATFORM(WIN)
  33. #include <windows.h>
  34. #endif
  35. #if HAVE(ACCESSIBILITY) && (PLATFORM(GTK) || PLATFORM(EFL))
  36. #include <atk/atk.h>
  37. #endif
  38. class AccessibilityController {
  39. public:
  40. AccessibilityController();
  41. ~AccessibilityController();
  42. void makeWindowObject(JSContextRef context, JSObjectRef windowObject, JSValueRef* exception);
  43. // Controller Methods - platform-independent implementations
  44. AccessibilityUIElement rootElement();
  45. AccessibilityUIElement focusedElement();
  46. AccessibilityUIElement elementAtPoint(int x, int y);
  47. AccessibilityUIElement accessibleElementById(JSStringRef id);
  48. void setLogFocusEvents(bool);
  49. void setLogValueChangeEvents(bool);
  50. void setLogScrollingStartEvents(bool);
  51. void setLogAccessibilityEvents(bool);
  52. void resetToConsistentState();
  53. // Global notification listener, captures notifications on any object.
  54. bool addNotificationListener(JSObjectRef functionCallback);
  55. void removeNotificationListener();
  56. #if PLATFORM(WIN)
  57. // Helper methods so this class can add the listeners on behalf of AccessibilityUIElement.
  58. void winAddNotificationListener(PlatformUIElement, JSObjectRef functionCallback);
  59. void winNotificationReceived(PlatformUIElement, const std::string& eventName);
  60. #endif
  61. #if HAVE(ACCESSIBILITY) && (PLATFORM(GTK) || PLATFORM(EFL))
  62. AtkObject* childElementById(AtkObject* parent, const char* id);
  63. #endif
  64. private:
  65. static JSClassRef getJSClass();
  66. #if PLATFORM(WIN)
  67. HWINEVENTHOOK m_focusEventHook;
  68. HWINEVENTHOOK m_valueChangeEventHook;
  69. HWINEVENTHOOK m_scrollingStartEventHook;
  70. HWINEVENTHOOK m_allEventsHook;
  71. HWINEVENTHOOK m_notificationsEventHook;
  72. HashMap<PlatformUIElement, JSObjectRef> m_notificationListeners;
  73. #endif
  74. #if PLATFORM(MAC)
  75. RetainPtr<NotificationHandler> m_globalNotificationHandler;
  76. #endif
  77. };
  78. #endif // AccessibilityController_h