| /************************************************************** | |
| * | |
| * 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. | |
| * | |
| *************************************************************/ | |
| import java.awt.Color; | |
| import java.awt.Font; | |
| import java.awt.Dimension; | |
| import javax.swing.JTextArea; | |
| import javax.swing.JScrollPane; | |
| import java.util.Vector; | |
| import com.sun.star.accessibility.XAccessible; | |
| import com.sun.star.accessibility.XAccessibleContext; | |
| import com.sun.star.accessibility.XAccessibleComponent; | |
| import com.sun.star.accessibility.XAccessibleStateSet; | |
| import com.sun.star.uno.AnyConverter; | |
| import com.sun.star.uno.UnoRuntime; | |
| import com.sun.star.awt.Point; | |
| import com.sun.star.awt.Size; | |
| /** Display textual information for a given accessible object. This | |
| includes the names of that object of its ancestors as well as some | |
| information retrieved from the XAccessibleContext and | |
| XAccessibleComponent interfaces. | |
| */ | |
| class TextualDisplay | |
| extends JScrollPane | |
| implements IAccessibleObjectDisplay | |
| { | |
| /** Create a new scroll pane that contains a text widget which display | |
| information about given accessible objects. | |
| */ | |
| public TextualDisplay () | |
| { | |
| // Create a text widget for displaying the text information... | |
| maText = new JTextArea (80,10); | |
| maText.setBackground (new Color (250,240,230)); | |
| maText.setFont (new Font ("Courier", Font.PLAIN, 11)); | |
| // ...and set-up the scroll pane to show this widget. | |
| setViewportView (maText); | |
| setVerticalScrollBarPolicy (JScrollPane.VERTICAL_SCROLLBAR_ALWAYS); | |
| setHorizontalScrollBarPolicy (JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS); | |
| } | |
| /** Set the accessible object to display. Call this method e.g. when a | |
| new object has been focused. | |
| */ | |
| public synchronized void setAccessibleObject (XAccessibleContext xContext) | |
| { | |
| // First clear the display area. | |
| msTextContent = new String (); | |
| if (xContext != null) | |
| { | |
| String sIndentation = showParents (xContext); | |
| showContextInfo (xContext, sIndentation); | |
| showComponentInfo (xContext, sIndentation); | |
| } | |
| maText.setText (msTextContent); | |
| } | |
| public synchronized void updateAccessibleObject (XAccessibleContext xContext) | |
| { | |
| setAccessibleObject (xContext); | |
| } | |
| /** Show some of the information available over the given object's | |
| XAccessibleContext interface. | |
| */ | |
| private void showContextInfo (XAccessibleContext xContext, String sIndentation) | |
| { | |
| // Show the description. | |
| msTextContent += sIndentation + "Description: " | |
| + xContext.getAccessibleDescription() + "\n"; | |
| showStates (xContext, sIndentation); | |
| } | |
| /** Show a list of all of the given object's states. Use the | |
| NameConverter class to transform the numerical state ids into human | |
| readable names. | |
| @param xContext | |
| The accessible context for which to show the state names. | |
| */ | |
| private void showStates (XAccessibleContext xContext, String sIndentation) | |
| { | |
| // Get the state set object... | |
| XAccessibleStateSet xStateSet = xContext.getAccessibleStateSet(); | |
| // ...and retrieve an array of numerical ids. | |
| short aStates[] = xStateSet.getStates(); | |
| // Iterate over the array and print the names of the states. | |
| msTextContent += sIndentation + "States : "; | |
| for (int i=0; i<aStates.length; i++) | |
| { | |
| if (i > 0) | |
| msTextContent += ", "; | |
| msTextContent += NameProvider.getStateName(aStates[i]); | |
| } | |
| msTextContent += "\n"; | |
| } | |
| /** When the given object supports the XAccessibleComponent interface then | |
| show its size and location on the screen. | |
| */ | |
| private void showComponentInfo (XAccessibleContext xContext, String sIndentation) | |
| { | |
| // Try to cast the given accessible context to the | |
| // XAccessibleComponent interface. | |
| XAccessibleComponent xComponent = | |
| UnoRuntime.queryInterface( | |
| XAccessibleComponent.class, xContext); | |
| if (xComponent != null) | |
| { | |
| Point aLocation = xComponent.getLocationOnScreen(); | |
| msTextContent += sIndentation + "Position : " | |
| + aLocation.X + ", " + aLocation.Y + "\n"; | |
| Size aSize = xComponent.getSize(); | |
| msTextContent += sIndentation + "Size : " | |
| + aSize.Width + ", " + aSize.Height + "\n"; | |
| } | |
| } | |
| /** Print the names of the given object and its parents and return an | |
| indentation string that can be used to print further information | |
| about the object. | |
| */ | |
| private String showParents (XAccessibleContext xContext) | |
| { | |
| // Create the path from the given object to its tree's root. | |
| Vector aPathToRoot = new Vector(); | |
| while (xContext != null) | |
| { | |
| aPathToRoot.add (xContext); | |
| // Go up the hierarchy one level to the object's parent. | |
| try | |
| { | |
| XAccessible xParent = xContext.getAccessibleParent(); | |
| if (xParent != null) | |
| xContext = xParent.getAccessibleContext(); | |
| else | |
| xContext = null; | |
| } | |
| catch (Exception e) | |
| { | |
| System.err.println ("caught exception " + e + " while getting path to root"); | |
| } | |
| } | |
| // Print the path in the accessibility tree from the given context to | |
| // the root. | |
| String sIndentation = new String (); | |
| for (int i=aPathToRoot.size()-1; i>=0; i--) | |
| { | |
| XAccessibleContext xParentContext = (XAccessibleContext)aPathToRoot.get(i); | |
| String sParentName = xParentContext.getAccessibleName(); | |
| if (sParentName.length() == 0) | |
| sParentName = "<unnamed> / Role " | |
| + NameProvider.getRoleName(xParentContext.getAccessibleRole()); | |
| msTextContent += sIndentation + sParentName + "\n"; | |
| sIndentation += msIndentation; | |
| } | |
| return sIndentation; | |
| } | |
| /// The text widget that is used for the actual text display. | |
| private JTextArea maText; | |
| /// The indentation with which an object's child is indented. | |
| private final String msIndentation = new String(" "); | |
| /// The text content displayed by this object. | |
| private String msTextContent = new String (); | |
| } |