/**************************************************************
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*************************************************************/
package complex.toolkit.accessibility;
import com.sun.star.awt.Point;
import com.sun.star.awt.Rectangle;
import com.sun.star.awt.Size;
import com.sun.star.uno.UnoRuntime;
import com.sun.star.accessibility.XAccessible;
import com.sun.star.accessibility.XAccessibleComponent;
import com.sun.star.accessibility.XAccessibleContext;
import com.sun.star.uno.XInterface;
import java.util.Vector;
/**
* Testing com.sun.star.accessibility.XAccessibleComponent
* interface methods :
*
containsPoint()
getAccessibleAtPoint()
getBounds()
getLocation()
getLocationOnScreen()
getSize()
grabFocus()
getAccessibleKeyBinding()
* * @see com.sun.star.accessibility.XAccessibleComponent */ public class _XAccessibleComponent { // private LogWriter log; public XAccessibleComponent oObj = null; private Rectangle bounds = null ; private static final String className = "com.sun.star.accessibility.XAccessibleComponent"; /** * Constructor * @param object */ public _XAccessibleComponent(XInterface object/*, LogWriter log*/) { oObj = UnoRuntime.queryInterface( XAccessibleComponent.class, object); // this.log = log; } /** * First checks 4 inner bounds (upper, lower, left and right) * of component bounding box to contain * at least one point of the component. Second 4 outer bounds * are checked to not contain any component points.
* * Has OK status if inner bounds contain component points * and outer bounds don't contain any component points.
* * The following method tests are to be completed successfully before : *
getBounds()
: to have size of a component.XAccessibleComponent
(if they exist) determines their
* boundaries and tries to get each child by getAccessibleAtPoint
* passing point which belongs to the child.
* Also the point is checked which doesn't belong to child boundary
* box.
*
* Has OK status if in the first cases the right children
* are returned, and in the second null
or
* another child is returned.
* @return
*/
public boolean _getAccessibleAtPoint() {
boolean result = true ;
XAccessibleComponent[] children = getChildrenComponents();
if (children.length > 0) {
for (int i = 0; i < children.length; i++) {
Rectangle chBnd = children[i].getBounds();
if (chBnd.X == -1)
{
continue;
}
System.out.println("Checking child with bounds " +
"(" + chBnd.X + "," + chBnd.Y + "),("
+ chBnd.Width + "," + chBnd.Height + "): "
+ util.AccessibilityTools.accessibleToString(children[i]));
System.out.println("finding the point which lies on the component");
int curX = 0;
int curY = 0;
while (!children[i].containsPoint(new Point(curX, curY))
&& curX < chBnd.Width) {
curX++;
curY++;
}
if (curX==chBnd.Width) {
System.out.println("Couldn't find a point with contains");
continue;
}
// trying the point laying on child
XAccessible xAcc = oObj.getAccessibleAtPoint
(new Point(chBnd.X , chBnd.Y));
if (xAcc == null) {
System.out.println("The child not found at point ("
+ (chBnd.X ) + "," + chBnd.Y + ") - FAILED");
result = false;
} else {
XAccessible xAccCh = UnoRuntime.queryInterface
(XAccessible.class, children[i]);
System.out.println("Child found at point ("
+ (chBnd.X ) + "," + chBnd.Y + ") - OK");
boolean res = util.AccessibilityTools.equals(xAccCh, xAcc);
if (!res) {
int expIndex = xAccCh.getAccessibleContext().getAccessibleIndexInParent();
int gotIndex = xAcc.getAccessibleContext().getAccessibleIndexInParent();
if (expIndex < gotIndex) {
System.out.println("The children found is not the same");
System.out.println("The expected child " +
xAccCh.getAccessibleContext().getAccessibleName());
System.out.println("is hidden behind the found Child ");
System.out.println(xAcc.getAccessibleContext().getAccessibleName()+" - OK");
} else {
System.out.println("The children found is not the same - FAILED");
System.out.println("Expected: "
+xAccCh.getAccessibleContext().getAccessibleName());
System.out.println("Found: "
+xAcc.getAccessibleContext().getAccessibleName());
result = false ;
}
}
}
// trying the point NOT laying on child
xAcc = oObj.getAccessibleAtPoint
(new Point(chBnd.X - 1, chBnd.Y - 1));
if (xAcc == null) {
System.out.println("No children found at point ("
+ (chBnd.X - 1) + "," + (chBnd.Y - 1) + ") - OK");
result &= true;
} else {
XAccessible xAccCh = UnoRuntime.queryInterface(XAccessible.class, children[i]);
boolean res = util.AccessibilityTools.equals(xAccCh, xAcc);
if (res) {
System.out.println("The same child found outside "
+ "its bounds - FAILED");
result = false ;
}
}
}
} else {
System.out.println("There are no children supporting "
+ "XAccessibleComponent");
}
return result;
}
/**
* Retrieves the component bounds and stores it.
* * Has OK status if boundary position (x,y) is not negative * and size (Width, Height) is greater than 0. * @return */ public boolean _getBounds() { boolean result = true ; bounds = oObj.getBounds() ; result &= bounds != null && bounds.X >=0 && bounds.Y >=0 && bounds.Width >0 && bounds.Height >0; System.out.println("Bounds = " + (bounds != null ? "(" + bounds.X + "," + bounds.Y + "),(" + bounds.Width + "," + bounds.Height + ")" : "null")); return result; } /** * Gets the location.
*
* Has OK status if the location is the same as location
* of boundary obtained by getBounds()
method.
*
* The following method tests are to be completed successfully before :
*
getBounds()
: to have bounds XAccessibleComponent
). * * Has OK status if component screen location equals * to screen location of its parent plus location of the component * relative to the parent.
* * The following method tests are to be completed successfully before : *
getBounds()
: to have location of the component
* relative to its parent* * Has OK status if the size is the same as in bounds.
* * The following method tests are to be completed successfully before : *
getBounds()
*
* Has OK status if no runtime exceptions occured.
* @return
*/
public boolean _grabFocus() {
boolean result = true ;
oObj.grabFocus() ;
return result ;
}
/**
* Retrieves all children (not more than 50) of the current
* component which support XAccessibleComponent
.
*
* @return The array of children. Empty array returned if
* such children were not found or some error occured.
*/
private XAccessibleComponent[] getChildrenComponents() {
XAccessible xAcc = UnoRuntime.queryInterface(XAccessible.class, oObj) ;
if (xAcc == null) {
System.out.println("Component doesn't support XAccessible.");
return new XAccessibleComponent[0];
}
XAccessibleContext xAccCon = xAcc.getAccessibleContext();
int cnt = xAccCon.getAccessibleChildCount();
// for cases when too many children exist checking only first 50
if (cnt > 50)
{
cnt = 50;
}
Vector childComp = new Vector();
for (int i = 0; i < cnt; i++) {
try {
XAccessible child = xAccCon.getAccessibleChild(i);
XAccessibleContext xAccConCh = child.getAccessibleContext();
XAccessibleComponent xChAccComp = UnoRuntime.queryInterface(XAccessibleComponent.class, xAccConCh);
if (xChAccComp != null) {
childComp.add(xChAccComp) ;
}
} catch (com.sun.star.lang.IndexOutOfBoundsException e) {}
}
return (XAccessibleComponent[]) childComp.toArray
(new XAccessibleComponent[childComp.size()]);
}
/**
* Gets the parent of the current component which support
* XAccessibleComponent
.
*
* @return The parent or null
if the component
* has no parent or some errors occured.
*/
private XAccessibleComponent getParentComponent() {
XAccessible xAcc = UnoRuntime.queryInterface(XAccessible.class, oObj) ;
if (xAcc == null) {
System.out.println("Component doesn't support XAccessible.");
return null;
}
XAccessibleContext xAccCon = xAcc.getAccessibleContext();
XAccessible xAccPar = xAccCon.getAccessibleParent();
if (xAccPar == null) {
System.out.println("Component has no accessible parent.");
return null;
}
XAccessibleContext xAccConPar = xAccPar.getAccessibleContext();
XAccessibleComponent parent = UnoRuntime.queryInterface(XAccessibleComponent.class, xAccConPar);
if (parent == null) {
System.out.println
("Accessible parent doesn't support XAccessibleComponent");
return null;
}
return parent;
}
/**
* Just calls the method.
* @return
*/
public boolean _getForeground() {
int forColor = oObj.getForeground();
System.out.println("getForeground(): " + forColor);
return true;
}
/**
* Just calls the method.
* @return
*/
public boolean _getBackground() {
int backColor = oObj.getBackground();
System.out.println("getBackground(): " + backColor);
return true;
}
}