| /* | |
| * Copyright (c) 2005, 2022, Oracle and/or its affiliates. All rights reserved. | |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. | |
| * | |
| * This code is free software; you can redistribute it and/or modify it | |
| * under the terms of the GNU General Public License version 2 only, as | |
| * published by the Free Software Foundation. Oracle designates this | |
| * particular file as subject to the "Classpath" exception as provided | |
| * by Oracle in the LICENSE file that accompanied this code. | |
| * | |
| * This code is distributed in the hope that it will be useful, but WITHOUT | |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| * version 2 for more details (a copy is included in the LICENSE file that | |
| * accompanied this code). | |
| * | |
| * You should have received a copy of the GNU General Public License version | |
| * 2 along with this work; if not, write to the Free Software Foundation, | |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. | |
| * | |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA | |
| * or visit www.oracle.com if you need additional information or have any | |
| * questions. | |
| */ | |
| /* Note: In addition to this header file AccessBridgeCalls.c must be compiled and | |
| * linked to your application. AccessBridgeCalls.c implements the Java Access | |
| * Bridge API and also hides the complexities associated with interfacing to the | |
| * associated Java Access Bridge DLL which is installed when Java is installed. | |
| * | |
| * AccessBridgeCalls.c is available for download from the OpenJDK repository using | |
| * the following link: | |
| * | |
| * https://git.openjdk.org/jdk17/blob/master/src/jdk.accessibility/windows/native/bridge/AccessBridgeCalls.c | |
| * | |
| * Also note that the API is used in the jaccessinspector and jaccesswalker tools. | |
| * The source for those tools is available in the OpenJDK repository at these links: | |
| * | |
| * https://git.openjdk.org/jdk17/blob/master/src/jdk.accessibility/windows/native/jaccessinspector/jaccessinspector.cpp | |
| * https://git.openjdk.org/jdk17/blob/master/src/jdk.accessibility/windows/native/jaccesswalker/jaccesswalker.cpp | |
| * | |
| * | |
| */ | |
| /* | |
| * Wrapper functions around calls to the AccessBridge DLL | |
| */ | |
| #include <windows.h> | |
| #include <jni.h> | |
| #include "AccessBridgeCallbacks.h" | |
| #include "AccessBridgePackages.h" | |
| #ifdef __cplusplus | |
| extern "C" { | |
| #endif | |
| #define null NULL | |
| typedef JOBJECT64 AccessibleContext; | |
| typedef JOBJECT64 AccessibleText; | |
| typedef JOBJECT64 AccessibleValue; | |
| typedef JOBJECT64 AccessibleSelection; | |
| typedef JOBJECT64 Java_Object; | |
| typedef JOBJECT64 PropertyChangeEvent; | |
| typedef JOBJECT64 FocusEvent; | |
| typedef JOBJECT64 CaretEvent; | |
| typedef JOBJECT64 MouseEvent; | |
| typedef JOBJECT64 MenuEvent; | |
| typedef JOBJECT64 AccessibleTable; | |
| typedef JOBJECT64 AccessibleHyperlink; | |
| typedef JOBJECT64 AccessibleHypertext; | |
| typedef void (*Windows_runFP) (); | |
| typedef void (*SetPropertyChangeFP) (AccessBridge_PropertyChangeFP fp); | |
| typedef void (*SetJavaShutdownFP) (AccessBridge_JavaShutdownFP fp); | |
| typedef void (*SetFocusGainedFP) (AccessBridge_FocusGainedFP fp); | |
| typedef void (*SetFocusLostFP) (AccessBridge_FocusLostFP fp); | |
| typedef void (*SetCaretUpdateFP) (AccessBridge_CaretUpdateFP fp); | |
| typedef void (*SetMouseClickedFP) (AccessBridge_MouseClickedFP fp); | |
| typedef void (*SetMouseEnteredFP) (AccessBridge_MouseEnteredFP fp); | |
| typedef void (*SetMouseExitedFP) (AccessBridge_MouseExitedFP fp); | |
| typedef void (*SetMousePressedFP) (AccessBridge_MousePressedFP fp); | |
| typedef void (*SetMouseReleasedFP) (AccessBridge_MouseReleasedFP fp); | |
| typedef void (*SetMenuCanceledFP) (AccessBridge_MenuCanceledFP fp); | |
| typedef void (*SetMenuDeselectedFP) (AccessBridge_MenuDeselectedFP fp); | |
| typedef void (*SetMenuSelectedFP) (AccessBridge_MenuSelectedFP fp); | |
| typedef void (*SetPopupMenuCanceledFP) (AccessBridge_PopupMenuCanceledFP fp); | |
| typedef void (*SetPopupMenuWillBecomeInvisibleFP) (AccessBridge_PopupMenuWillBecomeInvisibleFP fp); | |
| typedef void (*SetPopupMenuWillBecomeVisibleFP) (AccessBridge_PopupMenuWillBecomeVisibleFP fp); | |
| typedef void (*SetPropertyNameChangeFP) (AccessBridge_PropertyNameChangeFP fp); | |
| typedef void (*SetPropertyDescriptionChangeFP) (AccessBridge_PropertyDescriptionChangeFP fp); | |
| typedef void (*SetPropertyStateChangeFP) (AccessBridge_PropertyStateChangeFP fp); | |
| typedef void (*SetPropertyValueChangeFP) (AccessBridge_PropertyValueChangeFP fp); | |
| typedef void (*SetPropertySelectionChangeFP) (AccessBridge_PropertySelectionChangeFP fp); | |
| typedef void (*SetPropertyTextChangeFP) (AccessBridge_PropertyTextChangeFP fp); | |
| typedef void (*SetPropertyCaretChangeFP) (AccessBridge_PropertyCaretChangeFP fp); | |
| typedef void (*SetPropertyVisibleDataChangeFP) (AccessBridge_PropertyVisibleDataChangeFP fp); | |
| typedef void (*SetPropertyChildChangeFP) (AccessBridge_PropertyChildChangeFP fp); | |
| typedef void (*SetPropertyActiveDescendentChangeFP) (AccessBridge_PropertyActiveDescendentChangeFP fp); | |
| typedef void (*SetPropertyTableModelChangeFP) (AccessBridge_PropertyTableModelChangeFP fp); | |
| typedef void (*ReleaseJavaObjectFP) (long vmID, Java_Object object); | |
| typedef BOOL (*GetVersionInfoFP) (long vmID, AccessBridgeVersionInfo *info); | |
| typedef BOOL (*IsJavaWindowFP) (HWND window); | |
| typedef BOOL (*IsSameObjectFP) (long vmID, JOBJECT64 obj1, JOBJECT64 obj2); | |
| typedef BOOL (*GetAccessibleContextFromHWNDFP) (HWND window, long *vmID, AccessibleContext *ac); | |
| typedef HWND (*getHWNDFromAccessibleContextFP) (long vmID, AccessibleContext ac); | |
| typedef BOOL (*GetAccessibleContextAtFP) (long vmID, AccessibleContext acParent, | |
| jint x, jint y, AccessibleContext *ac); | |
| typedef BOOL (*GetAccessibleContextWithFocusFP) (HWND window, long *vmID, AccessibleContext *ac); | |
| typedef BOOL (*GetAccessibleContextInfoFP) (long vmID, AccessibleContext ac, AccessibleContextInfo *info); | |
| typedef AccessibleContext (*GetAccessibleChildFromContextFP) (long vmID, AccessibleContext ac, jint i); | |
| typedef AccessibleContext (*GetAccessibleParentFromContextFP) (long vmID, AccessibleContext ac); | |
| /* begin AccessibleTable */ | |
| typedef BOOL (*getAccessibleTableInfoFP) (long vmID, AccessibleContext ac, AccessibleTableInfo *tableInfo); | |
| typedef BOOL (*getAccessibleTableCellInfoFP) (long vmID, AccessibleTable accessibleTable, | |
| jint row, jint column, AccessibleTableCellInfo *tableCellInfo); | |
| typedef BOOL (*getAccessibleTableRowHeaderFP) (long vmID, AccessibleContext acParent, AccessibleTableInfo *tableInfo); | |
| typedef BOOL (*getAccessibleTableColumnHeaderFP) (long vmID, AccessibleContext acParent, AccessibleTableInfo *tableInfo); | |
| typedef AccessibleContext (*getAccessibleTableRowDescriptionFP) (long vmID, AccessibleContext acParent, jint row); | |
| typedef AccessibleContext (*getAccessibleTableColumnDescriptionFP) (long vmID, AccessibleContext acParent, jint column); | |
| typedef jint (*getAccessibleTableRowSelectionCountFP) (long vmID, AccessibleTable table); | |
| typedef BOOL (*isAccessibleTableRowSelectedFP) (long vmID, AccessibleTable table, jint row); | |
| typedef BOOL (*getAccessibleTableRowSelectionsFP) (long vmID, AccessibleTable table, jint count, | |
| jint *selections); | |
| typedef jint (*getAccessibleTableColumnSelectionCountFP) (long vmID, AccessibleTable table); | |
| typedef BOOL (*isAccessibleTableColumnSelectedFP) (long vmID, AccessibleTable table, jint column); | |
| typedef BOOL (*getAccessibleTableColumnSelectionsFP) (long vmID, AccessibleTable table, jint count, | |
| jint *selections); | |
| typedef jint (*getAccessibleTableRowFP) (long vmID, AccessibleTable table, jint index); | |
| typedef jint (*getAccessibleTableColumnFP) (long vmID, AccessibleTable table, jint index); | |
| typedef jint (*getAccessibleTableIndexFP) (long vmID, AccessibleTable table, jint row, jint column); | |
| /* end AccessibleTable */ | |
| /* AccessibleRelationSet */ | |
| typedef BOOL (*getAccessibleRelationSetFP) (long vmID, AccessibleContext accessibleContext, | |
| AccessibleRelationSetInfo *relationSetInfo); | |
| /* AccessibleHypertext */ | |
| typedef BOOL (*getAccessibleHypertextFP)(long vmID, AccessibleContext accessibleContext, | |
| AccessibleHypertextInfo *hypertextInfo); | |
| typedef BOOL (*activateAccessibleHyperlinkFP)(long vmID, AccessibleContext accessibleContext, | |
| AccessibleHyperlink accessibleHyperlink); | |
| typedef jint (*getAccessibleHyperlinkCountFP)(const long vmID, | |
| const AccessibleContext accessibleContext); | |
| typedef BOOL (*getAccessibleHypertextExtFP) (const long vmID, | |
| const AccessibleContext accessibleContext, | |
| const jint nStartIndex, | |
| AccessibleHypertextInfo *hypertextInfo); | |
| typedef jint (*getAccessibleHypertextLinkIndexFP)(const long vmID, | |
| const AccessibleHypertext hypertext, | |
| const jint nIndex); | |
| typedef BOOL (*getAccessibleHyperlinkFP)(const long vmID, | |
| const AccessibleHypertext hypertext, | |
| const jint nIndex, | |
| AccessibleHyperlinkInfo *hyperlinkInfo); | |
| /* Accessible KeyBindings, Icons and Actions */ | |
| typedef BOOL (*getAccessibleKeyBindingsFP)(long vmID, AccessibleContext accessibleContext, | |
| AccessibleKeyBindings *keyBindings); | |
| typedef BOOL (*getAccessibleIconsFP)(long vmID, AccessibleContext accessibleContext, | |
| AccessibleIcons *icons); | |
| typedef BOOL (*getAccessibleActionsFP)(long vmID, AccessibleContext accessibleContext, | |
| AccessibleActions *actions); | |
| typedef BOOL (*doAccessibleActionsFP)(long vmID, AccessibleContext accessibleContext, | |
| AccessibleActionsToDo *actionsToDo, jint *failure); | |
| /* AccessibleText */ | |
| typedef BOOL (*GetAccessibleTextInfoFP) (long vmID, AccessibleText at, AccessibleTextInfo *textInfo, jint x, jint y); | |
| typedef BOOL (*GetAccessibleTextItemsFP) (long vmID, AccessibleText at, AccessibleTextItemsInfo *textItems, jint index); | |
| typedef BOOL (*GetAccessibleTextSelectionInfoFP) (long vmID, AccessibleText at, AccessibleTextSelectionInfo *textSelection); | |
| typedef BOOL (*GetAccessibleTextAttributesFP) (long vmID, AccessibleText at, jint index, AccessibleTextAttributesInfo *attributes); | |
| typedef BOOL (*GetAccessibleTextRectFP) (long vmID, AccessibleText at, AccessibleTextRectInfo *rectInfo, jint index); | |
| typedef BOOL (*GetAccessibleTextLineBoundsFP) (long vmID, AccessibleText at, jint index, jint *startIndex, jint *endIndex); | |
| typedef BOOL (*GetAccessibleTextRangeFP) (long vmID, AccessibleText at, jint start, jint end, wchar_t *text, short len); | |
| typedef BOOL (*GetCurrentAccessibleValueFromContextFP) (long vmID, AccessibleValue av, wchar_t *value, short len); | |
| typedef BOOL (*GetMaximumAccessibleValueFromContextFP) (long vmID, AccessibleValue av, wchar_t *value, short len); | |
| typedef BOOL (*GetMinimumAccessibleValueFromContextFP) (long vmID, AccessibleValue av, wchar_t *value, short len); | |
| typedef void (*AddAccessibleSelectionFromContextFP) (long vmID, AccessibleSelection as, int i); | |
| typedef void (*ClearAccessibleSelectionFromContextFP) (long vmID, AccessibleSelection as); | |
| typedef JOBJECT64 (*GetAccessibleSelectionFromContextFP) (long vmID, AccessibleSelection as, int i); | |
| typedef int (*GetAccessibleSelectionCountFromContextFP) (long vmID, AccessibleSelection as); | |
| typedef BOOL (*IsAccessibleChildSelectedFromContextFP) (long vmID, AccessibleSelection as, int i); | |
| typedef void (*RemoveAccessibleSelectionFromContextFP) (long vmID, AccessibleSelection as, int i); | |
| typedef void (*SelectAllAccessibleSelectionFromContextFP) (long vmID, AccessibleSelection as); | |
| /* Utility methods */ | |
| typedef BOOL (*setTextContentsFP) (const long vmID, const AccessibleContext ac, const wchar_t *text); | |
| typedef AccessibleContext (*getParentWithRoleFP) (const long vmID, const AccessibleContext ac, const wchar_t *role); | |
| typedef AccessibleContext (*getParentWithRoleElseRootFP) (const long vmID, const AccessibleContext ac, const wchar_t *role); | |
| typedef AccessibleContext (*getTopLevelObjectFP) (const long vmID, const AccessibleContext ac); | |
| typedef int (*getObjectDepthFP) (const long vmID, const AccessibleContext ac); | |
| typedef AccessibleContext (*getActiveDescendentFP) (const long vmID, const AccessibleContext ac); | |
| typedef BOOL (*getVirtualAccessibleNameFP) (const long vmID, const AccessibleContext accessibleContext, | |
| wchar_t *name, int len); | |
| typedef BOOL (*requestFocusFP) (const long vmID, const AccessibleContext accessibleContext); | |
| typedef BOOL (*selectTextRangeFP) (const long vmID, const AccessibleContext accessibleContext, | |
| const int startIndex, const int endIndex); | |
| typedef BOOL (*getTextAttributesInRangeFP) (const long vmID, const AccessibleContext accessibleContext, | |
| const int startIndex, const int endIndex, | |
| AccessibleTextAttributesInfo *attributes, short *len); | |
| typedef int (*getVisibleChildrenCountFP) (const long vmID, const AccessibleContext accessibleContext); | |
| typedef BOOL (*getVisibleChildrenFP) (const long vmID, const AccessibleContext accessibleContext, | |
| const int startIndex, VisibleChildrenInfo *children); | |
| typedef BOOL (*setCaretPositionFP) (const long vmID, const AccessibleContext accessibleContext, const int position); | |
| typedef BOOL (*getCaretLocationFP) (long vmID, AccessibleContext ac, AccessibleTextRectInfo *rectInfo, jint index); | |
| typedef int (*getEventsWaitingFP) (); | |
| typedef struct AccessBridgeFPsTag { | |
| Windows_runFP Windows_run; | |
| SetPropertyChangeFP SetPropertyChange; | |
| SetJavaShutdownFP SetJavaShutdown; | |
| SetFocusGainedFP SetFocusGained; | |
| SetFocusLostFP SetFocusLost; | |
| SetCaretUpdateFP SetCaretUpdate; | |
| SetMouseClickedFP SetMouseClicked; | |
| SetMouseEnteredFP SetMouseEntered; | |
| SetMouseExitedFP SetMouseExited; | |
| SetMousePressedFP SetMousePressed; | |
| SetMouseReleasedFP SetMouseReleased; | |
| SetMenuCanceledFP SetMenuCanceled; | |
| SetMenuDeselectedFP SetMenuDeselected; | |
| SetMenuSelectedFP SetMenuSelected; | |
| SetPopupMenuCanceledFP SetPopupMenuCanceled; | |
| SetPopupMenuWillBecomeInvisibleFP SetPopupMenuWillBecomeInvisible; | |
| SetPopupMenuWillBecomeVisibleFP SetPopupMenuWillBecomeVisible; | |
| SetPropertyNameChangeFP SetPropertyNameChange; | |
| SetPropertyDescriptionChangeFP SetPropertyDescriptionChange; | |
| SetPropertyStateChangeFP SetPropertyStateChange; | |
| SetPropertyValueChangeFP SetPropertyValueChange; | |
| SetPropertySelectionChangeFP SetPropertySelectionChange; | |
| SetPropertyTextChangeFP SetPropertyTextChange; | |
| SetPropertyCaretChangeFP SetPropertyCaretChange; | |
| SetPropertyVisibleDataChangeFP SetPropertyVisibleDataChange; | |
| SetPropertyChildChangeFP SetPropertyChildChange; | |
| SetPropertyActiveDescendentChangeFP SetPropertyActiveDescendentChange; | |
| SetPropertyTableModelChangeFP SetPropertyTableModelChange; | |
| ReleaseJavaObjectFP ReleaseJavaObject; | |
| GetVersionInfoFP GetVersionInfo; | |
| IsJavaWindowFP IsJavaWindow; | |
| IsSameObjectFP IsSameObject; | |
| GetAccessibleContextFromHWNDFP GetAccessibleContextFromHWND; | |
| getHWNDFromAccessibleContextFP getHWNDFromAccessibleContext; | |
| GetAccessibleContextAtFP GetAccessibleContextAt; | |
| GetAccessibleContextWithFocusFP GetAccessibleContextWithFocus; | |
| GetAccessibleContextInfoFP GetAccessibleContextInfo; | |
| GetAccessibleChildFromContextFP GetAccessibleChildFromContext; | |
| GetAccessibleParentFromContextFP GetAccessibleParentFromContext; | |
| getAccessibleTableInfoFP getAccessibleTableInfo; | |
| getAccessibleTableCellInfoFP getAccessibleTableCellInfo; | |
| getAccessibleTableRowHeaderFP getAccessibleTableRowHeader; | |
| getAccessibleTableColumnHeaderFP getAccessibleTableColumnHeader; | |
| getAccessibleTableRowDescriptionFP getAccessibleTableRowDescription; | |
| getAccessibleTableColumnDescriptionFP getAccessibleTableColumnDescription; | |
| getAccessibleTableRowSelectionCountFP getAccessibleTableRowSelectionCount; | |
| isAccessibleTableRowSelectedFP isAccessibleTableRowSelected; | |
| getAccessibleTableRowSelectionsFP getAccessibleTableRowSelections; | |
| getAccessibleTableColumnSelectionCountFP getAccessibleTableColumnSelectionCount; | |
| isAccessibleTableColumnSelectedFP isAccessibleTableColumnSelected; | |
| getAccessibleTableColumnSelectionsFP getAccessibleTableColumnSelections; | |
| getAccessibleTableRowFP getAccessibleTableRow; | |
| getAccessibleTableColumnFP getAccessibleTableColumn; | |
| getAccessibleTableIndexFP getAccessibleTableIndex; | |
| getAccessibleRelationSetFP getAccessibleRelationSet; | |
| getAccessibleHypertextFP getAccessibleHypertext; | |
| activateAccessibleHyperlinkFP activateAccessibleHyperlink; | |
| getAccessibleHyperlinkCountFP getAccessibleHyperlinkCount; | |
| getAccessibleHypertextExtFP getAccessibleHypertextExt; | |
| getAccessibleHypertextLinkIndexFP getAccessibleHypertextLinkIndex; | |
| getAccessibleHyperlinkFP getAccessibleHyperlink; | |
| getAccessibleKeyBindingsFP getAccessibleKeyBindings; | |
| getAccessibleIconsFP getAccessibleIcons; | |
| getAccessibleActionsFP getAccessibleActions; | |
| doAccessibleActionsFP doAccessibleActions; | |
| GetAccessibleTextInfoFP GetAccessibleTextInfo; | |
| GetAccessibleTextItemsFP GetAccessibleTextItems; | |
| GetAccessibleTextSelectionInfoFP GetAccessibleTextSelectionInfo; | |
| GetAccessibleTextAttributesFP GetAccessibleTextAttributes; | |
| GetAccessibleTextRectFP GetAccessibleTextRect; | |
| GetAccessibleTextLineBoundsFP GetAccessibleTextLineBounds; | |
| GetAccessibleTextRangeFP GetAccessibleTextRange; | |
| GetCurrentAccessibleValueFromContextFP GetCurrentAccessibleValueFromContext; | |
| GetMaximumAccessibleValueFromContextFP GetMaximumAccessibleValueFromContext; | |
| GetMinimumAccessibleValueFromContextFP GetMinimumAccessibleValueFromContext; | |
| AddAccessibleSelectionFromContextFP AddAccessibleSelectionFromContext; | |
| ClearAccessibleSelectionFromContextFP ClearAccessibleSelectionFromContext; | |
| GetAccessibleSelectionFromContextFP GetAccessibleSelectionFromContext; | |
| GetAccessibleSelectionCountFromContextFP GetAccessibleSelectionCountFromContext; | |
| IsAccessibleChildSelectedFromContextFP IsAccessibleChildSelectedFromContext; | |
| RemoveAccessibleSelectionFromContextFP RemoveAccessibleSelectionFromContext; | |
| SelectAllAccessibleSelectionFromContextFP SelectAllAccessibleSelectionFromContext; | |
| setTextContentsFP setTextContents; | |
| getParentWithRoleFP getParentWithRole; | |
| getTopLevelObjectFP getTopLevelObject; | |
| getParentWithRoleElseRootFP getParentWithRoleElseRoot; | |
| getObjectDepthFP getObjectDepth; | |
| getActiveDescendentFP getActiveDescendent; | |
| getVirtualAccessibleNameFP getVirtualAccessibleName; | |
| requestFocusFP requestFocus; | |
| selectTextRangeFP selectTextRange; | |
| getTextAttributesInRangeFP getTextAttributesInRange; | |
| getVisibleChildrenCountFP getVisibleChildrenCount; | |
| getVisibleChildrenFP getVisibleChildren; | |
| setCaretPositionFP setCaretPosition; | |
| getCaretLocationFP getCaretLocation; | |
| getEventsWaitingFP getEventsWaiting; | |
| } AccessBridgeFPs; | |
| /** | |
| * Initialize the world | |
| */ | |
| BOOL initializeAccessBridge(); | |
| BOOL shutdownAccessBridge(); | |
| /** | |
| * Window routines | |
| */ | |
| BOOL IsJavaWindow(HWND window); | |
| // Returns the virtual machine ID and AccessibleContext for a top-level window | |
| BOOL GetAccessibleContextFromHWND(HWND target, long *vmID, AccessibleContext *ac); | |
| // Returns the HWND from the AccessibleContext of a top-level window | |
| HWND getHWNDFromAccessibleContext(long vmID, AccessibleContext ac); | |
| /** | |
| * Event handling routines | |
| */ | |
| void SetJavaShutdown(AccessBridge_JavaShutdownFP fp); | |
| void SetFocusGained(AccessBridge_FocusGainedFP fp); | |
| void SetFocusLost(AccessBridge_FocusLostFP fp); | |
| void SetCaretUpdate(AccessBridge_CaretUpdateFP fp); | |
| void SetMouseClicked(AccessBridge_MouseClickedFP fp); | |
| void SetMouseEntered(AccessBridge_MouseEnteredFP fp); | |
| void SetMouseExited(AccessBridge_MouseExitedFP fp); | |
| void SetMousePressed(AccessBridge_MousePressedFP fp); | |
| void SetMouseReleased(AccessBridge_MouseReleasedFP fp); | |
| void SetMenuCanceled(AccessBridge_MenuCanceledFP fp); | |
| void SetMenuDeselected(AccessBridge_MenuDeselectedFP fp); | |
| void SetMenuSelected(AccessBridge_MenuSelectedFP fp); | |
| void SetPopupMenuCanceled(AccessBridge_PopupMenuCanceledFP fp); | |
| void SetPopupMenuWillBecomeInvisible(AccessBridge_PopupMenuWillBecomeInvisibleFP fp); | |
| void SetPopupMenuWillBecomeVisible(AccessBridge_PopupMenuWillBecomeVisibleFP fp); | |
| void SetPropertyNameChange(AccessBridge_PropertyNameChangeFP fp); | |
| void SetPropertyDescriptionChange(AccessBridge_PropertyDescriptionChangeFP fp); | |
| void SetPropertyStateChange(AccessBridge_PropertyStateChangeFP fp); | |
| void SetPropertyValueChange(AccessBridge_PropertyValueChangeFP fp); | |
| void SetPropertySelectionChange(AccessBridge_PropertySelectionChangeFP fp); | |
| void SetPropertyTextChange(AccessBridge_PropertyTextChangeFP fp); | |
| void SetPropertyCaretChange(AccessBridge_PropertyCaretChangeFP fp); | |
| void SetPropertyVisibleDataChange(AccessBridge_PropertyVisibleDataChangeFP fp); | |
| void SetPropertyChildChange(AccessBridge_PropertyChildChangeFP fp); | |
| void SetPropertyActiveDescendentChange(AccessBridge_PropertyActiveDescendentChangeFP fp); | |
| void SetPropertyTableModelChange(AccessBridge_PropertyTableModelChangeFP fp); | |
| /** | |
| * General routines | |
| */ | |
| void ReleaseJavaObject(long vmID, Java_Object object); | |
| BOOL GetVersionInfo(long vmID, AccessBridgeVersionInfo *info); | |
| HWND GetHWNDFromAccessibleContext(long vmID, JOBJECT64 accesibleContext); | |
| /** | |
| * Accessible Context routines | |
| */ | |
| BOOL GetAccessibleContextAt(long vmID, AccessibleContext acParent, | |
| jint x, jint y, AccessibleContext *ac); | |
| BOOL GetAccessibleContextWithFocus(HWND window, long *vmID, AccessibleContext *ac); | |
| BOOL GetAccessibleContextInfo(long vmID, AccessibleContext ac, AccessibleContextInfo *info); | |
| AccessibleContext GetAccessibleChildFromContext(long vmID, AccessibleContext ac, jint index); | |
| AccessibleContext GetAccessibleParentFromContext(long vmID, AccessibleContext ac); | |
| /** | |
| * Accessible Text routines | |
| */ | |
| BOOL GetAccessibleTextInfo(long vmID, AccessibleText at, AccessibleTextInfo *textInfo, jint x, jint y); | |
| BOOL GetAccessibleTextItems(long vmID, AccessibleText at, AccessibleTextItemsInfo *textItems, jint index); | |
| BOOL GetAccessibleTextSelectionInfo(long vmID, AccessibleText at, AccessibleTextSelectionInfo *textSelection); | |
| BOOL GetAccessibleTextAttributes(long vmID, AccessibleText at, jint index, AccessibleTextAttributesInfo *attributes); | |
| BOOL GetAccessibleTextRect(long vmID, AccessibleText at, AccessibleTextRectInfo *rectInfo, jint index); | |
| BOOL GetAccessibleTextLineBounds(long vmID, AccessibleText at, jint index, jint *startIndex, jint *endIndex); | |
| BOOL GetAccessibleTextRange(long vmID, AccessibleText at, jint start, jint end, wchar_t *text, short len); | |
| /* begin AccessibleTable routines */ | |
| BOOL getAccessibleTableInfo(long vmID, AccessibleContext acParent, AccessibleTableInfo *tableInfo); | |
| BOOL getAccessibleTableCellInfo(long vmID, AccessibleTable accessibleTable, jint row, jint column, | |
| AccessibleTableCellInfo *tableCellInfo); | |
| BOOL getAccessibleTableRowHeader(long vmID, AccessibleContext acParent, AccessibleTableInfo *tableInfo); | |
| BOOL getAccessibleTableColumnHeader(long vmID, AccessibleContext acParent, AccessibleTableInfo *tableInfo); | |
| AccessibleContext getAccessibleTableRowDescription(long vmID, AccessibleContext acParent, jint row); | |
| AccessibleContext getAccessibleTableColumnDescription(long vmID, AccessibleContext acParent, jint column); | |
| jint getAccessibleTableRowSelectionCount(long vmID, AccessibleTable table); | |
| BOOL isAccessibleTableRowSelected(long vmID, AccessibleTable table, jint row); | |
| BOOL getAccessibleTableRowSelections(long vmID, AccessibleTable table, jint count, jint *selections); | |
| jint getAccessibleTableColumnSelectionCount(long vmID, AccessibleTable table); | |
| BOOL isAccessibleTableColumnSelected(long vmID, AccessibleTable table, jint column); | |
| BOOL getAccessibleTableColumnSelections(long vmID, AccessibleTable table, jint count, jint *selections); | |
| jint getAccessibleTableRow(long vmID, AccessibleTable table, jint index); | |
| jint getAccessibleTableColumn(long vmID, AccessibleTable table, jint index); | |
| jint getAccessibleTableIndex(long vmID, AccessibleTable table, jint row, jint column); | |
| /* end AccessibleTable */ | |
| /* ----- AccessibleRelationSet routines */ | |
| BOOL getAccessibleRelationSet(long vmID, AccessibleContext accessibleContext, | |
| AccessibleRelationSetInfo *relationSetInfo); | |
| /* ----- AccessibleHypertext routines */ | |
| /* | |
| * Returns hypertext information associated with a component. | |
| */ | |
| BOOL getAccessibleHypertext(long vmID, AccessibleContext accessibleContext, | |
| AccessibleHypertextInfo *hypertextInfo); | |
| /* | |
| * Requests that a hyperlink be activated. | |
| */ | |
| BOOL activateAccessibleHyperlink(long vmID, AccessibleContext accessibleContext, | |
| AccessibleHyperlink accessibleHyperlink); | |
| /* | |
| * Returns the number of hyperlinks in a component | |
| * Maps to AccessibleHypertext.getLinkCount. | |
| * Returns -1 on error. | |
| */ | |
| jint getAccessibleHyperlinkCount(const long vmID, | |
| const AccessibleHypertext hypertext); | |
| /* | |
| * This method is used to iterate through the hyperlinks in a component. It | |
| * returns hypertext information for a component starting at hyperlink index | |
| * nStartIndex. No more than MAX_HYPERLINKS AccessibleHypertextInfo objects will | |
| * be returned for each call to this method. | |
| * Returns FALSE on error. | |
| */ | |
| BOOL getAccessibleHypertextExt(const long vmID, | |
| const AccessibleContext accessibleContext, | |
| const jint nStartIndex, | |
| /* OUT */ AccessibleHypertextInfo *hypertextInfo); | |
| /* | |
| * Returns the index into an array of hyperlinks that is associated with | |
| * a character index in document; maps to AccessibleHypertext.getLinkIndex | |
| * Returns -1 on error. | |
| */ | |
| jint getAccessibleHypertextLinkIndex(const long vmID, | |
| const AccessibleHypertext hypertext, | |
| const jint nIndex); | |
| /* | |
| * Returns the nth hyperlink in a document | |
| * Maps to AccessibleHypertext.getLink. | |
| * Returns FALSE on error | |
| */ | |
| BOOL getAccessibleHyperlink(const long vmID, | |
| const AccessibleHypertext hypertext, | |
| const jint nIndex, | |
| /* OUT */ AccessibleHyperlinkInfo *hyperlinkInfo); | |
| /* Accessible KeyBindings, Icons and Actions */ | |
| /* | |
| * Returns a list of key bindings associated with a component. | |
| */ | |
| BOOL getAccessibleKeyBindings(long vmID, AccessibleContext accessibleContext, | |
| AccessibleKeyBindings *keyBindings); | |
| /* | |
| * Returns a list of icons associate with a component. | |
| */ | |
| BOOL getAccessibleIcons(long vmID, AccessibleContext accessibleContext, | |
| AccessibleIcons *icons); | |
| /* | |
| * Returns a list of actions that a component can perform. | |
| */ | |
| BOOL getAccessibleActions(long vmID, AccessibleContext accessibleContext, | |
| AccessibleActions *actions); | |
| /* | |
| * Request that a list of AccessibleActions be performed by a component. | |
| * Returns TRUE if all actions are performed. Returns FALSE | |
| * when the first requested action fails in which case "failure" | |
| * contains the index of the action that failed. | |
| */ | |
| BOOL doAccessibleActions(long vmID, AccessibleContext accessibleContext, | |
| AccessibleActionsToDo *actionsToDo, jint *failure); | |
| /* Additional utility methods */ | |
| /* | |
| * Returns whether two object references refer to the same object. | |
| */ | |
| BOOL IsSameObject(long vmID, JOBJECT64 obj1, JOBJECT64 obj2); | |
| /** | |
| * Sets editable text contents. The AccessibleContext must implement AccessibleEditableText and | |
| * be editable. The maximum text length that can be set is MAX_STRING_SIZE - 1. | |
| * Returns whether successful | |
| */ | |
| BOOL setTextContents (const long vmID, const AccessibleContext accessibleContext, const wchar_t *text); | |
| /** | |
| * Returns the Accessible Context with the specified role that is the | |
| * ancestor of a given object. The role is one of the role strings | |
| * defined in AccessBridgePackages.h | |
| * If there is no ancestor object that has the specified role, | |
| * returns (AccessibleContext)0. | |
| */ | |
| AccessibleContext getParentWithRole (const long vmID, const AccessibleContext accessibleContext, | |
| const wchar_t *role); | |
| /** | |
| * Returns the Accessible Context with the specified role that is the | |
| * ancestor of a given object. The role is one of the role strings | |
| * defined in AccessBridgePackages.h. If an object with the specified | |
| * role does not exist, returns the top level object for the Java Window. | |
| * Returns (AccessibleContext)0 on error. | |
| */ | |
| AccessibleContext getParentWithRoleElseRoot (const long vmID, const AccessibleContext accessibleContext, | |
| const wchar_t *role); | |
| /** | |
| * Returns the Accessible Context for the top level object in | |
| * a Java Window. This is same Accessible Context that is obtained | |
| * from GetAccessibleContextFromHWND for that window. Returns | |
| * (AccessibleContext)0 on error. | |
| */ | |
| AccessibleContext getTopLevelObject (const long vmID, const AccessibleContext accessibleContext); | |
| /** | |
| * Returns how deep in the object hierarchy a given object is. | |
| * The top most object in the object hierarchy has an object depth of 0. | |
| * Returns -1 on error. | |
| */ | |
| int getObjectDepth (const long vmID, const AccessibleContext accessibleContext); | |
| /** | |
| * Returns the Accessible Context of the current ActiveDescendent of an object. | |
| * This method assumes the ActiveDescendent is the component that is currently | |
| * selected in a container object. | |
| * Returns (AccessibleContext)0 on error or if there is no selection. | |
| */ | |
| AccessibleContext getActiveDescendent (const long vmID, const AccessibleContext accessibleContext); | |
| /** | |
| * Accessible Value routines | |
| */ | |
| BOOL GetCurrentAccessibleValueFromContext(long vmID, AccessibleValue av, wchar_t *value, short len); | |
| BOOL GetMaximumAccessibleValueFromContext(long vmID, AccessibleValue av, wchar_t *value, short len); | |
| BOOL GetMinimumAccessibleValueFromContext(long vmID, AccessibleValue av, wchar_t *value, short len); | |
| /** | |
| * Accessible Selection routines | |
| */ | |
| void AddAccessibleSelectionFromContext(long vmID, AccessibleSelection as, int i); | |
| void ClearAccessibleSelectionFromContext(long vmID, AccessibleSelection as); | |
| JOBJECT64 GetAccessibleSelectionFromContext(long vmID, AccessibleSelection as, int i); | |
| int GetAccessibleSelectionCountFromContext(long vmID, AccessibleSelection as); | |
| BOOL IsAccessibleChildSelectedFromContext(long vmID, AccessibleSelection as, int i); | |
| void RemoveAccessibleSelectionFromContext(long vmID, AccessibleSelection as, int i); | |
| void SelectAllAccessibleSelectionFromContext(long vmID, AccessibleSelection as); | |
| /** | |
| * Additional methods for Teton | |
| */ | |
| /** | |
| * Gets the AccessibleName for a component based upon the JAWS algorithm. Returns | |
| * whether successful. | |
| * | |
| * Bug ID 4916682 - Implement JAWS AccessibleName policy | |
| */ | |
| BOOL getVirtualAccessibleName(const long vmID, const AccessibleContext accessibleContext, | |
| wchar_t *name, int len); | |
| /** | |
| * Request focus for a component. Returns whether successful. | |
| * | |
| * Bug ID 4944757 - requestFocus method needed | |
| */ | |
| BOOL requestFocus(const long vmID, const AccessibleContext accessibleContext); | |
| /** | |
| * Selects text between two indices. Selection includes the text at the start index | |
| * and the text at the end index. Returns whether successful. | |
| * | |
| * Bug ID 4944758 - selectTextRange method needed | |
| */ | |
| BOOL selectTextRange(const long vmID, const AccessibleContext accessibleContext, const int startIndex, | |
| const int endIndex); | |
| /** | |
| * Get text attributes between two indices. The attribute list includes the text at the | |
| * start index and the text at the end index. Returns whether successful; | |
| * | |
| * Bug ID 4944761 - getTextAttributes between two indices method needed | |
| */ | |
| BOOL getTextAttributesInRange(const long vmID, const AccessibleContext accessibleContext, | |
| const int startIndex, const int endIndex, | |
| AccessibleTextAttributesInfo *attributes, short *len); | |
| /** | |
| * Returns the number of visible children of a component. Returns -1 on error. | |
| * | |
| * Bug ID 4944762- getVisibleChildren for list-like components needed | |
| */ | |
| int getVisibleChildrenCount(const long vmID, const AccessibleContext accessibleContext); | |
| /** | |
| * Gets the visible children of an AccessibleContext. Returns whether successful. | |
| * | |
| * Bug ID 4944762- getVisibleChildren for list-like components needed | |
| */ | |
| BOOL getVisibleChildren(const long vmID, const AccessibleContext accessibleContext, | |
| const int startIndex, | |
| VisibleChildrenInfo *visibleChildrenInfo); | |
| /** | |
| * Set the caret to a text position. Returns whether successful. | |
| * | |
| * Bug ID 4944770 - setCaretPosition method needed | |
| */ | |
| BOOL setCaretPosition(const long vmID, const AccessibleContext accessibleContext, | |
| const int position); | |
| /** | |
| * Gets the text caret location | |
| */ | |
| BOOL getCaretLocation(long vmID, AccessibleContext ac, | |
| AccessibleTextRectInfo *rectInfo, jint index); | |
| /** | |
| * Gets the number of events waiting to fire | |
| */ | |
| int getEventsWaiting(); | |
| #ifdef __cplusplus | |
| } | |
| #endif |