abbot.tester
Class JTreeTester

java.lang.Object
  abbot.tester.Robot
      abbot.tester.ComponentTester
          abbot.tester.ContainerTester
              abbot.tester.JComponentTester
                  abbot.tester.JTreeTester

All Implemented Interfaces:

AWTConstants

public class JTreeTester
extends JComponentTester

Provide operations on a JTree component. The JTree substructure is a "row", and JTreeLocation provides different identifiers for a row.

• Select an item by row index
• Select an item by tree path (the string representation of the full path).

See Also:

JTreeLocation

Field Summary

Fields inherited from class abbot.tester.ComponentTester

IGNORED_METHODS

Fields inherited from class abbot.tester.Robot

componentDelay, defaultDelay, EM_AWT, EM_ROBOT, IDLE_TIMEOUT, MOUSELESS_MODIFIER, MOUSELESS_MODIFIER_MASK, popupDelay

Fields inherited from interface abbot.tester.AWTConstants

BUTTON_MASK, COPY_MASK, DRAG_THRESHOLD, LINK_MASK, MENU_SHORTCUT_KEYCODE, MENU_SHORTCUT_MASK, MENU_SHORTCUT_MODIFIER, MENU_SHORTCUT_STRING, MOVE_MASK, MULTI_CLICK_INTERVAL, POPUP_MASK, POPUP_MODIFIER, POPUP_ON_PRESS, TERTIARY_MASK, TERTIARY_MODIFIER

Constructor Summary

JTreeTester()

Method Summary

void	actionClick(Component c, ComponentLocation loc) Click at the given location.
void	actionClickRow(Component tree, int row) Simple click on the given row.
void	actionClickRow(Component tree, int row, String modifiers) Deprecated. Use the ComponentLocation version.
void	actionClickRow(Component c, int row, String modifiers, int count) Deprecated. Use the ComponentLocation version.
void	actionMakeVisible(Component c, TreePath path) Ensure all elements of the given path are visible.
void	actionSelectPath(Component c, TreePath path) Select the given path, expanding parent nodes if necessary.
void	actionSelectRow(Component c, ComponentLocation loc) Select the given row.
void	actionSelectRow(Component tree, int row) Select the given row.
void	actionToggleRow(Component c, ComponentLocation loc) Change the open/closed state of the given row, if possible.
void	actionToggleRow(Component c, int row) Deprecated. Use the ComponentLocation version instead.
boolean	assertPathExists(Component tree, TreePath path) Determine whether a given path exists, expanding ancestor nodes as necessary to find it.
boolean	assertPathExists(Component tree, TreePath path, boolean invert) Determine whether a given path exists, expanding ancestor nodes as necessary to find it.
boolean	assertPathExists(Component tree, TreePath path, int timeout, boolean invert) Determine whether a given path exists, expanding ancestor nodes as necessary to find it.
ComponentLocation	getLocation(Component c, Point p) Convert the coordinate into a more meaningful location.
static boolean	isLocationInExpandControl(JTree tree, int x, int y) Returns whether the given point is in one of the JTree's node expansion controls.
protected boolean	makeVisible(Component c, TreePath path) Make the given path visible, if possible, and returns whether any action was taken.
ComponentLocation	parseLocation(String encoded) Parse the String representation of a JTreeLocation into the actual JTreeLocation object.
static TreePath	pathToStringPath(JTree tree, TreePath path) Return the String representation of the given TreePath, or null if one can not be obtained.
static String	valueToString(JTree tree, TreePath path) Return a unique String representation of the final component of the given TreePath, or null if one can not be obtained.

Methods inherited from class abbot.tester.JComponentTester

actionActionMap, actionClick, actionClick, actionDrag, actionDrag, actionDrop, actionScrollToVisible, actionScrollToVisible, actionScrollToVisible, convertRendererToString, deriveTag, getTester, isVisible, isVisible, mousePress, scrollRectToVisible, scrollToVisible, scrollToVisible

Methods inherited from class abbot.tester.ComponentTester

actionClick, actionClick, actionClick, actionClick, actionClick, actionDelay, actionDrag, actionDrag, actionDrag, actionDrag, actionDragOver, actionDragOver, actionDrop, actionDrop, actionFocus, actionKeyPress, actionKeyPress, actionKeyRelease, actionKeyRelease, actionKeyString, actionKeyString, actionKeyStroke, actionKeyStroke, actionKeyStroke, actionKeyStroke, actionMouseMove, actionMousePress, actionMousePress, actionMouseRelease, actionSelectAWTMenuItem, actionSelectAWTMenuItemByLabel, actionSelectAWTPopupMenuItem, actionSelectAWTPopupMenuItemByLabel, actionSelectMenuItem, actionSelectMenuItem, actionSelectPopupMenuItem, actionSelectPopupMenuItem, actionSelectPopupMenuItem, actionSetModifiers, actionShowPopupMenu, actionShowPopupMenu, actionShowPopupMenu, actionWaitForIdle, assertComponentShowing, assertFrameShowing, assertFrameShowing, assertImage, deriveAccessibleTag, getActions, getAssertMethods, getComponentActions, getComponentAssertMethods, getPropertyMethods, getTag, getTestedClass, getTester, getTester, isCustom, isExtension, setTester, stripHTML, waitAction, waitForComponentShowing, waitForFrameShowing, waitForFrameShowing

Methods inherited from class abbot.tester.Robot

activate, canMoveWindows, canResizeWindows, capture, capture, capture, click, click, click, click, click, close, deiconify, delay, descriptiveClassName, drag, drag, dragOver, drop, findFocusOwner, fireAccessibleAction, focus, focus, getAutoDelay, getBorderTitle, getCanonicalClass, getCloseLocation, getDescriptiveName, getEventID, getEventID, getEventMode, getEventModeDescription, getEventPostDelay, getEventQueue, getIconifyLocation, getIconName, getIndex, getLabel, getMaximizeLocation, getMoveLocation, getName, getPreferredRobotAutoDelay, getResizeLocation, getRobot, getState, getText, getTitle, iconify, invokeAction, invokeAction, invokeAndWait, invokeAndWait, invokeLater, invokeLater, isReadyForInput, jitter, jitter, key, key, keyPress, keyRelease, keyString, keyStroke, maximize, mouseMove, mouseMove, mousePress, mousePress, mousePress, mousePress, mouseRelease, mouseRelease, move, moveBy, normalize, postEvent, postInvocationEvent, queueBlocked, reset, resize, resizeBy, sample, sample, sample, selectAWTMenuItem, selectAWTMenuItem, selectAWTMenuItemByLabel, selectAWTPopupMenuItem, selectAWTPopupMenuItem, selectAWTPopupMenuItemByLabel, selectMenuItem, selectMenuItem, selectPopupMenuItem, sendEvent, setAutoDelay, setEventMode, setEventPostDelay, setModifiers, showPopupMenu, showPopupMenu, simpleClassName, sleep, toHierarchyPath, toString, toString, toString, userMovable, userResizable, useScreenMenuBar, wait, wait, wait, waitForIdle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JTreeTester

public JTreeTester()

Method Detail

isLocationInExpandControl

public static boolean isLocationInExpandControl(JTree tree,
                                                int x,
                                                int y)

Returns whether the given point is in one of the JTree's node expansion controls.

valueToString

public static String valueToString(JTree tree,
                                   TreePath path)

Return a unique String representation of the final component of the given TreePath, or null if one can not be obtained. Assumes the path is visible.

pathToStringPath

public static TreePath pathToStringPath(JTree tree,
                                        TreePath path)

Return the String representation of the given TreePath, or null if one can not be obtained. Assumes the path is visible.

actionClick

public void actionClick(Component c,
                        ComponentLocation loc)

Click at the given location. If the location indicates a path, ensure it is visible first.

Overrides:

actionClick in class ComponentTester

actionSelectRow

public void actionSelectRow(Component c,
                            ComponentLocation loc)

Select the given row. If the row is already selected, does nothing.

actionSelectRow

public void actionSelectRow(Component tree,
                            int row)

Select the given row. If the row is already selected, does nothing. Equivalent to actionSelectRow(c, new JTreeLocation(row)).

actionClickRow

public void actionClickRow(Component tree,
                           int row)

Simple click on the given row.

actionClickRow

public void actionClickRow(Component tree,
                           int row,
                           String modifiers)

Deprecated. Use the ComponentLocation version.

Click with modifiers on the given row.

actionClickRow

public void actionClickRow(Component c,
                           int row,
                           String modifiers,
                           int count)

Deprecated. Use the ComponentLocation version.

Multiple click on the given row.

makeVisible

protected boolean makeVisible(Component c,
                              TreePath path)

Make the given path visible, if possible, and returns whether any action was taken.

Throws:

LocationUnavailableException - if no corresponding path can be found.

actionMakeVisible

public void actionMakeVisible(Component c,
                              TreePath path)

Ensure all elements of the given path are visible.

actionSelectPath

public void actionSelectPath(Component c,
                             TreePath path)

Select the given path, expanding parent nodes if necessary.

actionToggleRow

public void actionToggleRow(Component c,
                            int row)

Deprecated. Use the ComponentLocation version instead.

Change the open/closed state of the given row, if possible.

actionToggleRow

public void actionToggleRow(Component c,
                            ComponentLocation loc)

Change the open/closed state of the given row, if possible.

assertPathExists

public boolean assertPathExists(Component tree,
                                TreePath path)

Determine whether a given path exists, expanding ancestor nodes as necessary to find it.

Returns:

Whether the given path on the given tree exists.

assertPathExists

public boolean assertPathExists(Component tree,
                                TreePath path,
                                boolean invert)

Determine whether a given path exists, expanding ancestor nodes as necessary to find it.

Parameters:

invert - Whether it invert the sense of this operation, when inverted it assumed a timeout of zero.

Returns:

Whether the given path on the given tree exists.

assertPathExists

public boolean assertPathExists(Component tree,
                                TreePath path,
                                int timeout,
                                boolean invert)

Determine whether a given path exists, expanding ancestor nodes as necessary to find it.

Parameters:

timeout - How long to wait for the tree path to become avaliable

invert - Whether it invert the sense of this operation

Returns:

Whether the given path on the given tree exists.

parseLocation

public ComponentLocation parseLocation(String encoded)

Parse the String representation of a JTreeLocation into the actual JTreeLocation object.

Overrides:

parseLocation in class ComponentTester

getLocation

public ComponentLocation getLocation(Component c,
                                     Point p)

Convert the coordinate into a more meaningful location. Namely, use a path, row, or coordinate.

Overrides:

getLocation in class ComponentTester