8800cbe5079183a5fdea02fbced10cc708bf5462
[WebKit-https.git] / WebKitTools / DumpRenderTree / AccessibilityUIElement.h
1 /*
2  * Copyright (C) 2008 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
26 #ifndef AccessibilityUIElement_h
27 #define AccessibilityUIElement_h
28
29 #include <JavaScriptCore/JSObjectRef.h>
30 #include <wtf/Platform.h>
31 #include <wtf/Vector.h>
32
33 #if PLATFORM(MAC)
34 #ifdef __OBJC__
35 typedef id PlatformUIElement;
36 #else
37 typedef struct objc_object* PlatformUIElement;
38 #endif
39 #elif PLATFORM(WIN)
40 #undef _WINSOCKAPI_
41 #define _WINSOCKAPI_ // Prevent inclusion of winsock.h in windows.h
42
43 #include <oleacc.h>
44 #include <WebCore/COMPtr.h>
45
46 typedef COMPtr<IAccessible> PlatformUIElement;
47 #elif PLATFORM(GTK)
48 #include <atk/atk.h>
49 typedef AtkObject* PlatformUIElement;
50 #else
51 typedef void* PlatformUIElement;
52 #endif
53
54 class AccessibilityUIElement {
55 public:
56     AccessibilityUIElement(PlatformUIElement);
57     AccessibilityUIElement(const AccessibilityUIElement&);
58     ~AccessibilityUIElement();
59
60     PlatformUIElement platformUIElement() { return m_element; }
61
62     static JSObjectRef makeJSAccessibilityUIElement(JSContextRef, const AccessibilityUIElement&);
63
64     bool isEqual(AccessibilityUIElement* otherElement) { return platformUIElement() == otherElement->platformUIElement(); }
65     
66     void getLinkedUIElements(Vector<AccessibilityUIElement>&);
67     void getDocumentLinks(Vector<AccessibilityUIElement>&);
68     void getChildren(Vector<AccessibilityUIElement>&);
69     void getChildrenWithRange(Vector<AccessibilityUIElement>&, unsigned location, unsigned length);
70     
71     AccessibilityUIElement elementAtPoint(int x, int y);
72     AccessibilityUIElement getChildAtIndex(unsigned);
73     int childrenCount();
74     AccessibilityUIElement titleUIElement();
75     AccessibilityUIElement parentElement();
76     
77     // Methods - platform-independent implementations
78     JSStringRef allAttributes();
79     JSStringRef attributesOfLinkedUIElements();
80     JSStringRef attributesOfDocumentLinks();
81     JSStringRef attributesOfChildren();
82     JSStringRef parameterizedAttributeNames();
83     void increment();
84     void decrement();
85     void showMenu();
86
87     // Attributes - platform-independent implementations
88     JSStringRef attributeValue(JSStringRef attribute);
89     bool isAttributeSettable(JSStringRef attribute);
90     bool isActionSupported(JSStringRef action);
91     JSStringRef role();
92     JSStringRef subrole();
93     JSStringRef title();
94     JSStringRef description();
95     JSStringRef language();
96     JSStringRef stringValue();
97     JSStringRef accessibilityValue() const;
98     double x();
99     double y();
100     double width();
101     double height();
102     double intValue();
103     double minValue();
104     double maxValue();
105     JSStringRef valueDescription();
106     int insertionPointLineNumber();
107     JSStringRef selectedTextRange();
108     bool isEnabled();
109     bool isRequired() const;
110     bool isSelected() const;
111     bool isExpanded() const;
112     int hierarchicalLevel() const;
113     double clickPointX();
114     double clickPointY();
115
116     // Table-specific attributes
117     JSStringRef attributesOfColumnHeaders();
118     JSStringRef attributesOfRowHeaders();
119     JSStringRef attributesOfColumns();
120     JSStringRef attributesOfRows();
121     JSStringRef attributesOfVisibleCells();
122     JSStringRef attributesOfHeader();
123     int indexInTable();
124     JSStringRef rowIndexRange();
125     JSStringRef columnIndexRange();
126     
127     // Tree/Outline specific attributes
128     AccessibilityUIElement selectedRowAtIndex(unsigned);
129     AccessibilityUIElement disclosedByRow();
130     AccessibilityUIElement disclosedRowAtIndex(unsigned);
131     
132     // Parameterized attributes
133     int lineForIndex(int);
134     JSStringRef boundsForRange(unsigned location, unsigned length);
135     void setSelectedTextRange(unsigned location, unsigned length);
136     JSStringRef stringForRange(unsigned location, unsigned length);
137     
138     // Table-specific
139     AccessibilityUIElement cellForColumnAndRow(unsigned column, unsigned row);
140
141 private:
142     static JSClassRef getJSClass();
143
144     PlatformUIElement m_element;
145 };
146
147 #endif // AccessibilityUIElement_h