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

Nested Class Summary

Nested classes/interfaces inherited from class abbot.tester.Robot

Robot.ConditionEDTDecorator

Field Summary

Fields inherited from class abbot.tester.ComponentTester

IGNORED_METHODS

Fields inherited from class abbot.tester.Robot

componentDelay, defaultDelay, DRAG_DELAY, EM_AWT, EM_ROBOT, IDLE_TIMEOUT, MOUSELESS_MODIFIER, MOUSELESS_MODIFIER_MASK, popupDelay, popupJitterDelay, popupRetry, REALSYNC_IDLE_TIMEOUT, REALSYNC_IDLE_TIMEOUT_DEFAULT

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

Constructors

Constructor and Description
JTreeTester()

Method Summary

Methods

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

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

valueToString

public static java.lang.String valueToString(javax.swing.JTree tree,
                             javax.swing.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.

dumpTree

public static java.lang.String dumpTree(javax.swing.JTree tree)

Parameters:

tree - The tree to dump

Returns:

A textual representaiton of the current tree

pathToStringPath

public static javax.swing.tree.TreePath pathToStringPath(javax.swing.JTree tree,
                                         javax.swing.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(java.awt.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(java.awt.Component c,
                   ComponentLocation loc)

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

actionSelectRow

public void actionSelectRow(java.awt.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(java.awt.Component tree,
                  int row)

Simple click on the given row.

actionClickRow

public void actionClickRow(java.awt.Component tree,
                  int row,
                  java.lang.String modifiers)

Deprecated. Use the ComponentLocation version.

Click with modifiers on the given row.

actionClickRow

public void actionClickRow(java.awt.Component c,
                  int row,
                  java.lang.String modifiers,
                  int count)

Deprecated. Use the ComponentLocation version.

Multiple click on the given row.

makeVisible

protected boolean makeVisible(java.awt.Component c,
                  javax.swing.tree.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(java.awt.Component c,
                     javax.swing.tree.TreePath path)

Ensure all elements of the given path are visible.

actionSelectPath

public void actionSelectPath(java.awt.Component c,
                    javax.swing.tree.TreePath path)

Select the given path, expanding parent nodes if necessary.

actionToggleRow

public void actionToggleRow(java.awt.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(java.awt.Component c,
                   ComponentLocation loc)

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

assertPathExists

public boolean assertPathExists(java.awt.Component tree,
                       javax.swing.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(java.awt.Component tree,
                       javax.swing.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(java.awt.Component tree,
                       javax.swing.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(java.lang.String encoded)

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

Overrides:

parseLocation in class ComponentTester

getLocation

public ComponentLocation getLocation(java.awt.Component c,
                            java.awt.Point p)

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

Overrides:

getLocation in class ComponentTester