|
|
/*
* Copyright (c) 2005, 2016, 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: * * http://hg.openjdk.java.net/jdk9/jdk9/jdk/raw-file/tip/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: * * http://hg.openjdk.java.net/jdk9/jdk9/jdk/file/tip/src/jdk.accessibility/windows/native/jaccessinspector/jaccessinspector.cpp
* http://hg.openjdk.java.net/jdk9/jdk9/jdk/file/tip/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
|
