Java Accessibility Guide

Java Platform, Standard Edition

Java Accessibility Guide

Release 11

November 2018

Java Platform, Standard Edition Java Accessibility Guide, Release 11

Copyright © 1993, 2018, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on

you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on

behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software,

any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are

"commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-

specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the

programs, including any operating system, integrated software, any programs installed on the hardware,

and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.

No other rights are granted to the U.S. Government.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of

their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are

used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron,

the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro

Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products,

and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly

disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise

set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be

1 Java Accessibility Overview

2 Java Access Bridge Overview

3 Enabling and Testing Java Access Bridge

6 Accessibility Properties

7 Java Accessibility Utilities Overview

Chapter 1

BOOL GetAccessibleContextAt(long vmID, AccessibleContext acParent, jint x, jint

y, AccessibleContext *ac)

BOOL GetAccessibleContextWithFocus(HWND window, long *vmID, AccessibleContext

BOOL GetAccessibleContextInfo(long vmID, AccessibleContext ac,

AccessibleContextInfo *info);

AccessibleContext GetAccessibleChildFromContext(long vmID, AccessibleContext ac,

AccessibleContext GetAccessibleParentFromContext(long vmID, AccessibleContext

HWND getHWNDFromAccessibleContext(long vmID, AccessibleContext ac);

BOOL GetAccessibleTextSelectionInfo(long vmID, AccessibleText

at, AccessibleTextSelectionInfo *textSelection);

char *GetAccessibleTextAttributes(long vmID, AccessibleText

at, jint index, AccessibleTextAttributesInfo *attributes);

BOOL GetAccessibleTextRect(long vmID, AccessibleText at, AccessibleTextRectInfo

*rectInfo, jint index);

BOOL GetAccessibleTextRange(long vmID, AccessibleText at, jint

start, jint end, wchar_t *text, short len);

BOOL GetAccessibleTextLineBounds(long vmID, AccessibleText

at, jint index, jint *startIndex, jint *endIndex);

accessibleContext, const int startIndex, const int endIndex,

BOOL setCaretPosition(const long vmID, const AccessibleContext

accessibleContext, const int position);

BOOL getCaretLocation(long vmID, AccessibleContext ac, AccessibleTextRectInfo

*rectInfo, jint index);

BOOL setTextContents (const long vmID, const AccessibleContext

jint getAccessibleTableColumnSelectionCount(long vmID, AccessibleTable table);

jint getAccessibleHypertextLinkIndex(const long vmID, const AccessibleHypertext

BOOL IsSameObject(long vmID, JOBJECT64 obj1, JOBJECT64 obj2);

AccessibleContext getParentWithRole (const long vmID, const AccessibleContext

accessibleContext, const wchar_t *role);

AccessibleContext getParentWithRoleElseRoot (const long vmID, const

int getObjectDepth (const long vmID, const AccessibleContext accessibleContext);

AccessibleContext getActiveDescendent (const long vmID, const AccessibleContext

int getVisibleChildrenCount(const long vmID, const AccessibleContext

BOOL getVisibleChildren(const long vmID, const AccessibleContext

accessibleContext, const int startIndex, VisibleChildrenInfo *visibleChildrenInfo);

int getEventsWaiting();

BOOL GetCurrentAccessibleValueFromContext(long vmID, AccessibleValue av, wchar_t

*value, short len);

BOOL GetMaximumAccessibleValueFromContext(long vmID, AccessibleValue av, wchar_

*value, short len);

BOOL GetMinimumAccessibleValueFromContext(long vmID, AccessibleValue av, wchar_

*value, short len);

void AddAccessibleSelectionFromContext(long vmID, AccessibleSelection

as, int i);

void ClearAccessibleSelectionFromContext(long vmID, AccessibleSelection

jobject GetAccessibleSelectionFromContext(long vmID, AccessibleSelection

as, int i);

int GetAccessibleSelectionCountFromContext(long vmID, AccessibleSelection

#define MAX_STRING_SIZE 1024

#define SHORT_STRING_SIZE 256

typedef struct AccessibleContextInfoTag {

jint childrenCount // # of children, if any

jint x; // screen x-axis co-ordinate in pixels

jint y; // screen y-axis co-ordinate in pixels

jint width; // pixel width of object

jint height; // pixel height of object

BOOL accessibleComponent; // flags for various additional

BOOL accessibleAction; // Java Accessibility interfaces

BOOL accessibleSelection; // FALSE if this object doesn't

BOOL accessibleText; // implement the additional interface

BOOL accessibleInterfaces; // new bitfield containing additional

jint indexAtPoint; // index at the passsed in point

} AccessibleTextInfo;

typedef struct AccessibleTextItemsInfoTag {

wchar_t letter;

wchar_t word[SHORT_STRING_SIZE];

wchar_t sentence[MAX_STRING_SIZE];

} AccessibleTextItemsInfo;

typedef struct AccessibleTextSelectionInfoTag {

jint selectionStartIndex;

jint y; // y-axis co-ordinate

jint width; // bounding rectangle width

jint height; // bounding rectangle height

} AccessibleTextRectInfo;

BOOL bold;

BOOL italic;

BOOL underline;

BOOL strikethrough;

jint alignment;

jint bidiLevel;

jfloat firstLineIndent;

jfloat leftIndent;

jfloat rightIndent;

jfloat lineSpacing;

jfloat spaceAbove;

jfloat spaceBelow;

wchar_t fullAttributesString[MAX_STRING_SIZE];

} AccessibleTextAttributesInfo;

JOBJECT64 accessibleTable;

} AccessibleTableInfo;