|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface IAccessibleElement
interface for exposing accessibility-related properties to the validation engine. Because ACTF is an accessibility validation environment, each element of a hierarchical structure (especially of a GUI hierarchy) will most often be exposed as either that element itself or as an accessible object. This 'accessible object' is usually different from the original element and exposes properties of the original element that aid asisstive technologies in rendering the element in an alternative manner.
This interface provides a way for elements to be viewed as accessible objects by exposing the most commonly queried properties. It permits different structures to present properties to the ACTF engine in a consistent manner.
In most cases, implementations of this interface will be primarily native and platform-dependent.
Method Summary | |
---|---|
void |
checkIsValid()
checks whether or not this accessible element is in a valid state. |
Object |
element()
get the element associated with this accessible element |
Object |
getAccessibleAction()
return the default action |
int |
getAccessibleChildCount()
return the number of children of this element. |
IAccessibleElement[] |
getAccessibleChildren()
return all of the children of this accessible element. |
String |
getAccessibleDescription()
return description or use of control |
int |
getAccessibleIndexInParent()
retreave the index of this accessible within its parent accessible |
String |
getAccessibleKeyboardShortcut()
return the keyboard shortcut or mnemonic |
Rectangle |
getAccessibleLocation()
Gets the bounds of this object in the form of a Rectangle object. |
String |
getAccessibleName()
return the name or short description of this element |
IAccessibleElement |
getAccessibleParent()
returns the parent accessible object. |
String |
getAccessibleRole()
return role or function of control. |
IAccessibleElement[] |
getAccessibleSelection()
get the list of selected accessibles. |
Set |
getAccessibleState()
return the state of the control. |
Object |
getAccessibleValue()
return the value (e.g. of a scroll bar or combo) |
Method Detail |
---|
Object element()
null
if this object was not initialized in such a way that the original element is availablevoid checkIsValid() throws InvalidComponentException
Accessing properties of invalid accessible elements will raise an
InvalidComponentException
.
InvalidComponentException
IAccessibleElement getAccessibleParent() throws InvalidComponentException
null
if no parent for this element exists
InvalidComponentException
int getAccessibleIndexInParent() throws InvalidComponentException
InvalidComponentException
int getAccessibleChildCount() throws InvalidComponentException
InvalidComponentException
IAccessibleElement[] getAccessibleChildren() throws InvalidComponentException
InvalidComponentException
String getAccessibleName() throws InvalidComponentException
InvalidComponentException
Object getAccessibleValue() throws InvalidComponentException
InvalidComponentException
String getAccessibleKeyboardShortcut() throws InvalidComponentException
InvalidComponentException
Object getAccessibleAction() throws InvalidComponentException
null
if no default action is provided
InvalidComponentException
String getAccessibleDescription() throws InvalidComponentException
InvalidComponentException
String getAccessibleRole() throws InvalidComponentException
Note: All attempts will be made to
return one of the pre-defined role constants in AccessibleConstants
. Should the role be
unknown or not match one of the pre-defined constants, the original
role string from the underlying accessibility model will be returned.
InvalidComponentException
AccessibleConstants
Set getAccessibleState() throws InvalidComponentException
Note: All attempts will be made to
return one of the pre-defined state constants in AccessibleConstants
. Should the state be
unknown or not match one of the pre-defined constants, the original
state from the underlying accessibility model will be returned.
InvalidComponentException
AccessibleConstants
IAccessibleElement[] getAccessibleSelection() throws InvalidComponentException
InvalidComponentException
Rectangle getAccessibleLocation() throws InvalidComponentException
InvalidComponentException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |