org.fest.swing.driver.JTreeDriver

public class JTreeDriver extends JComponentDriver

Understands functional testing of JTrees:

user input simulation
state verification
property value query

This class is intended for internal use only. Please use the classes in the package org.fest.swing.fixture in your tests.

Field Summary

Fields

Modifier and Type

Field

Description

private static final String

EDITABLE_PROPERTY

private final JTreeLocation

location

private final JTreePathFinder

pathFinder

private static final String

SELECTION_PROPERTY

Fields inherited from class org.fest.swing.driver.ComponentDriver
robot
Constructor Summary

Constructors

Constructor

Description

JTreeDriver(Robot robot)

Creates a new JTreeDriver.
Method Summary

Modifier and Type

Method

Description

private void

assertEditable(JTree tree, boolean editable)

(package private) JTreeCellReader

cellReader()

void

cellReader(JTreeCellReader newCellReader)

Updates the implementation of JTreeCellReader to use when comparing internal values of a JTree and the values expected in a test.

private void

clearSelection(JTree tree)

void

clickPath(JTree tree, String path)

Clicks the given path, expanding parent nodes if necessary.

void

clickPath(JTree tree, String path, MouseButton button)

Clicks the given path, expanding parent nodes if necessary.

private void

clickPath(JTree tree, String path, MouseButton button, int times)

void

clickPath(JTree tree, String path, MouseClickInfo mouseClickInfo)

Clicks the given path, expanding parent nodes if necessary.

void

clickRow(JTree tree, int row)

Clicks the given row.

void

clickRow(JTree tree, int row, MouseButton button)

Clicks the given row.

private void

clickRow(JTree tree, int row, MouseButton button, int times)

void

clickRow(JTree tree, int row, MouseClickInfo mouseClickInfo)

Clicks the given row.

void

collapsePath(JTree tree, String path)

Collapses the given path, is possible.

void

collapseRow(JTree tree, int row)

Collapses the given row, is possible.

private void

doubleClick(JTree tree, Point p)

void

doubleClickPath(JTree tree, String path)

Double-clicks the given path.

void

doubleClickRow(JTree tree, int row)

Double-clicks the given row.

void

drag(JTree tree, int row)

Starts a drag operation at the location of the given row.

void

drag(JTree tree, String path)

Starts a drag operation at the location of the given TreePath.

void

drop(JTree tree, int row)

Ends a drag operation at the location of the given row.

void

drop(JTree tree, String path)

Ends a drag operation at the location of the given TreePath.

private static org.fest.assertions.Description

editableProperty(JTree tree)

void

expandPath(JTree tree, String path)

Expands the given path, is possible.

void

expandRow(JTree tree, int row)

Expands the given row, is possible.

private boolean

makeParentVisible(JTree tree, TreePath path)

private boolean

makeVisible(JTree tree, TreePath path, boolean expandWhenFound)

Matches, makes visible, and expands the path one component at a time, from uppermost ancestor on down, since children may be lazily loaded/created.

String

nodeValue(JTree tree, int row)

Returns the String representation of the node at the given row index.

String

nodeValue(JTree tree, String path)

Returns the String representation of the node at the given path.

void

requireEditable(JTree tree)

Asserts that the given JTree is editable.

void

requireNoSelection(JTree tree)

Asserts that the given JTree does not have any selection.

void

requireNotEditable(JTree tree)

Asserts that the given JTree is not editable.

void

requireSelection(JTree tree, int[] rows)

Asserts that the given JTree's selected rows are equal to the given one.

void

requireSelection(JTree tree, String[] paths)

Asserts that the given JTree's selected paths are equal to the given one.

private void

rightClick(JTree tree, Point p)

void

rightClickPath(JTree tree, String path)

Right-clicks the given path, expanding parent nodes if necessary.

void

rightClickRow(JTree tree, int row)

Right-clicks the given row.

private Point

scrollAndSelectRow(JTree tree, int row)

private Triple<TreePath,Boolean,Point>

scrollToMatchingPath(JTree tree, String path)

private static Triple<Boolean,Point,Integer>

scrollToMatchingPathAndGetToggleInfo(JTree tree, String path, JTreePathFinder pathFinder, JTreeLocation location)

private Point

scrollToPath(JTree tree, String path)

private static Pair<Boolean,Point>

scrollToPathToSelect(JTree tree, TreePath path, JTreeLocation location)

private Point

scrollToRow(JTree tree, int row)

private static Pair<Boolean,Point>

scrollToRow(JTree tree, int row, JTreeLocation location)

private static Triple<Boolean,Point,Integer>

scrollToRowAndGetToggleInfo(JTree tree, int row, JTreeLocation location)

private static Point

scrollToTreePath(JTree tree, TreePath path, JTreeLocation location)

private static Point

scrollToVisible(JTree tree, int row, JTreeLocation location)

private org.fest.assertions.Description

selectionProperty(JTree tree)

private Point

selectMatchingPath(JTree tree, String path)

void

selectPath(JTree tree, String path)

Selects the given path, expanding parent nodes if necessary.

void

selectPaths(JTree tree, String[] paths)

Selects the given paths, expanding parent nodes if necessary.

void

selectRow(JTree tree, int row)

Selects the given row.

void

selectRows(JTree tree, int[] rows)

Selects the given rows.

String

separator()

Returns the separator to use when converting TreePaths to Strings.

void

separator(String newSeparator)

Updates the separator to use when converting TreePaths to Strings.

JPopupMenu

showPopupMenu(JTree tree, int row)

Shows a pop-up menu at the position of the node in the given row.

JPopupMenu

showPopupMenu(JTree tree, String path)

Shows a pop-up menu at the position of the last node in the given path.

private void

toggleCell(JTree tree, Point p, int toggleClickCount)

void

toggleRow(JTree tree, int row)

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

private static void

toggleRowThroughTreeUI(JTree tree, Point p)

private void

validateIsNotNull(MouseButton button)

private void

validateIsNotNull(MouseClickInfo mouseClickInfo)

void

validatePath(JTree tree, String path)

Verifies that the given node path exists.

private void

validatePaths(String[] paths)

void

validateRow(JTree tree, int row)

Verifies that the given row index is valid.

private void

validateRows(int[] rows)

private void

waitForChildrenToShowUp(JTree tree, TreePath path)

Methods inherited from class org.fest.swing.driver.JComponentDriver
clientProperty, invokeAction, isVisible, isVisible, requireToolTip, requireToolTip, scrollToVisible

Methods inherited from class org.fest.swing.driver.ContainerDriver
move, resize, resizeHeight, resizeWidth

Methods inherited from class org.fest.swing.driver.ComponentDriver
assertIsEnabledAndShowing, click, click, click, click, click, doubleClick, drag, dragOver, drop, focus, focusAndWaitForFocusGain, invokePopupMenu, invokePopupMenu, moveMouseIgnoringAnyError, moveMouseIgnoringAnyError, performAccessibleActionOf, pressAndReleaseKey, pressAndReleaseKey, pressAndReleaseKeys, pressKey, propertyName, releaseKey, requireDisabled, requireEnabled, requireEnabled, requireFocused, requireNotVisible, requireSize, requireVisible, rightClick, settings, waitForShowing

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- EDITABLE_PROPERTY
  
  private static final String EDITABLE_PROPERTY
  See Also:
  
  Constant Field Values
- SELECTION_PROPERTY
  
  private static final String SELECTION_PROPERTY
  See Also:
  
  Constant Field Values
- location
  
  private final JTreeLocation location
- pathFinder
  
  private final JTreePathFinder pathFinder
Constructor Details
- JTreeDriver
  
  public JTreeDriver(Robot robot)
  
  Creates a new JTreeDriver.
  
  Parameters:
  
  robot - the robot to use to simulate user input.
Method Details
- clickRow
  
  @RunsInEDT public void clickRow(JTree tree, int row)
  
  Clicks the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  Since:
  
  1.2
- clickRow
  
  @RunsInEDT public void clickRow(JTree tree, int row, MouseButton button)
  
  Clicks the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  button - the mouse button to use.
  
  Throws:
  
  NullPointerException - if the given button is null.
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  Since:
  
  1.2
- clickRow
  
  @RunsInEDT public void clickRow(JTree tree, int row, MouseClickInfo mouseClickInfo)
  
  Clicks the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  mouseClickInfo - specifies the mouse button to use and how many times to click.
  
  Throws:
  
  NullPointerException - if the given MouseClickInfo is null.
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  Since:
  
  1.2
- clickRow
  
  @RunsInEDT private void clickRow(JTree tree, int row, MouseButton button, int times)
- doubleClickRow
  
  @RunsInEDT public void doubleClickRow(JTree tree, int row)
  
  Double-clicks the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  Since:
  
  1.2
- rightClickRow
  
  @RunsInEDT public void rightClickRow(JTree tree, int row)
  
  Right-clicks the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  Since:
  
  1.2
- scrollToRow
  
  @RunsInEDT private Point scrollToRow(JTree tree, int row)
- clickPath
  
  @RunsInEDT public void clickPath(JTree tree, String path)
  
  Clicks the given path, expanding parent nodes if necessary.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to path.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
- clickPath
  
  @RunsInEDT public void clickPath(JTree tree, String path, MouseButton button)
  
  Clicks the given path, expanding parent nodes if necessary.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to path.
  
  button - the mouse button to use.
  
  Throws:
  
  NullPointerException - if the given button is null.
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  Since:
  
  1.2
- validateIsNotNull
  
  private void validateIsNotNull(MouseButton button)
- clickPath
  
  @RunsInEDT public void clickPath(JTree tree, String path, MouseClickInfo mouseClickInfo)
  
  Clicks the given path, expanding parent nodes if necessary.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to path.
  
  mouseClickInfo - specifies the mouse button to use and how many times to click.
  
  Throws:
  
  NullPointerException - if the given MouseClickInfo is null.
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  Since:
  
  1.2
- validateIsNotNull
  
  private void validateIsNotNull(MouseClickInfo mouseClickInfo)
- clickPath
  
  private void clickPath(JTree tree, String path, MouseButton button, int times)
- doubleClickPath
  
  @RunsInEDT public void doubleClickPath(JTree tree, String path)
  
  Double-clicks the given path.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to double-click.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  Since:
  
  1.2
- scrollToPath
  
  private Point scrollToPath(JTree tree, String path)
- doubleClick
  
  private void doubleClick(JTree tree, Point p)
- rightClickPath
  
  @RunsInEDT public void rightClickPath(JTree tree, String path)
  
  Right-clicks the given path, expanding parent nodes if necessary.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to path.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  Since:
  
  1.2
- rightClick
  
  private void rightClick(JTree tree, Point p)
- expandRow
  
  @RunsInEDT public void expandRow(JTree tree, int row)
  
  Expands the given row, is possible. If the row is already expanded, this method will not do anything.
  NOTE: a reasonable assumption is that the toggle control is just to the left of the row bounds and is roughly a square the dimensions of the row height. Clicking in the center of that square should work.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  ActionFailedException - if this method fails to expand the row.
  
  Since:
  
  1.2
- collapseRow
  
  @RunsInEDT public void collapseRow(JTree tree, int row)
  
  Collapses the given row, is possible. If the row is already collapsed, this method will not do anything.
  NOTE: a reasonable assumption is that the toggle control is just to the left of the row bounds and is roughly a square the dimensions of the row height. Clicking in the center of that square should work.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  ActionFailedException - if this method fails to collapse the row.
  
  Since:
  
  1.2
- toggleRow
  
  @RunsInEDT public void toggleRow(JTree tree, int row)
  
  Change the open/closed state of the given row, if possible.
  NOTE: a reasonable assumption is that the toggle control is just to the left of the row bounds and is roughly a square the dimensions of the row height. Clicking in the center of that square should work.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  ActionFailedException - if this method fails to toggle the row.
- scrollToRowAndGetToggleInfo
  
  @RunsInEDT private static Triple<Boolean,Point,Integer> scrollToRowAndGetToggleInfo(JTree tree, int row, JTreeLocation location)
- expandPath
  
  @RunsInEDT public void expandPath(JTree tree, String path)
  
  Expands the given path, is possible. If the path is already expanded, this method will not do anything.
  NOTE: a reasonable assumption is that the toggle control is just to the left of the row bounds and is roughly a square the dimensions of the row height. Clicking in the center of that square should work.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to expand.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  ActionFailedException - if this method fails to expand the path.
  
  Since:
  
  1.2
- collapsePath
  
  @RunsInEDT public void collapsePath(JTree tree, String path)
  
  Collapses the given path, is possible. If the path is already expanded, this method will not do anything.
  NOTE: a reasonable assumption is that the toggle control is just to the left of the row bounds and is roughly a square the dimensions of the row height. Clicking in the center of that square should work.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to collapse.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  ActionFailedException - if this method fails to collapse the path.
  
  Since:
  
  1.2
- scrollToMatchingPathAndGetToggleInfo
  
  @RunsInEDT private static Triple<Boolean,Point,Integer> scrollToMatchingPathAndGetToggleInfo(JTree tree, String path, JTreePathFinder pathFinder, JTreeLocation location)
- toggleCell
  
  @RunsInEDT private void toggleCell(JTree tree, Point p, int toggleClickCount)
- toggleRowThroughTreeUI
  
  @RunsInEDT private static void toggleRowThroughTreeUI(JTree tree, Point p)
- selectRows
  
  @RunsInEDT public void selectRows(JTree tree, int[] rows)
  
  Selects the given rows.
  
  Parameters:
  
  tree - the target JTree.
  
  rows - the rows to select.
  
  Throws:
  
  NullPointerException - if the array of rows is null.
  
  IllegalArgumentException - if the array of rows is empty.
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if any of the given rows is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for any of the given rows cannot be found.
- validateRows
  
  private void validateRows(int[] rows)
- clearSelection
  
  @RunsInEDT private void clearSelection(JTree tree)
- selectRow
  
  @RunsInEDT public void selectRow(JTree tree, int row)
  
  Selects the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the row to select.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
- selectPaths
  
  @RunsInEDT public void selectPaths(JTree tree, String[] paths)
  
  Selects the given paths, expanding parent nodes if necessary.
  
  Parameters:
  
  tree - the target JTree.
  
  paths - the paths to select.
  
  Throws:
  
  NullPointerException - if the array of rows is null.
  
  IllegalArgumentException - if the array of rows is empty.
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if any the given path cannot be found.
- validatePaths
  
  private void validatePaths(String[] paths)
- selectPath
  
  @RunsInEDT public void selectPath(JTree tree, String path)
  
  Selects the given path, expanding parent nodes if necessary. Unlike clickPath(JTree, String), this method will not click the path if it is already selected
  
  Parameters:
  
  tree - the target JTree.
  
  path - the path to select.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
- showPopupMenu
  
  @RunsInEDT public JPopupMenu showPopupMenu(JTree tree, int row)
  
  Shows a pop-up menu at the position of the node in the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Returns:
  
  a driver that manages the displayed pop-up menu.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  ComponentLookupException - if a pop-up menu cannot be found.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
- showPopupMenu
  
  @RunsInEDT public JPopupMenu showPopupMenu(JTree tree, String path)
  
  Shows a pop-up menu at the position of the last node in the given path. The last node in the given path will be made visible (by expanding the parent node(s)) if it is not visible.
  Parameters:
  
  tree - the target JTree.
  
  path - the given path.
  
  Returns:
  
  a driver that manages the displayed pop-up menu.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  ComponentLookupException - if a pop-up menu cannot be found.
  
  LocationUnavailableException - if the given path cannot be found.
  
  See Also:
  
  separator(String)
- drag
  
  @RunsInEDT public void drag(JTree tree, int row)
  
  Starts a drag operation at the location of the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
- scrollAndSelectRow
  
  @RunsInEDT private Point scrollAndSelectRow(JTree tree, int row)
- drop
  
  @RunsInEDT public void drop(JTree tree, int row)
  
  Ends a drag operation at the location of the given row.
  
  Parameters:
  
  tree - the target JTree.
  
  row - the given row.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  ActionFailedException - if there is no drag action in effect.
- scrollToRow
  
  @RunsInEDT private static Pair<Boolean,Point> scrollToRow(JTree tree, int row, JTreeLocation location)
- scrollToVisible
  
  @RunsInCurrentThread private static Point scrollToVisible(JTree tree, int row, JTreeLocation location)
- drag
  
  @RunsInEDT public void drag(JTree tree, String path)
  
  Starts a drag operation at the location of the given TreePath.
  Parameters:
  
  tree - the target JTree.
  
  path - the given path.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  See Also:
  
  separator(String)
- selectMatchingPath
  
  @RunsInEDT private Point selectMatchingPath(JTree tree, String path)
- drop
  
  @RunsInEDT public void drop(JTree tree, String path)
  
  Ends a drag operation at the location of the given TreePath.
  Parameters:
  
  tree - the target JTree.
  
  path - the given path.
  
  Throws:
  
  IllegalStateException - if the JTree is disabled.
  
  IllegalStateException - if the JTree is not showing on the screen.
  
  LocationUnavailableException - if the given path cannot be found.
  
  ActionFailedException - if there is no drag action in effect.
  
  See Also:
  
  separator(String)
- scrollToMatchingPath
  
  @RunsInEDT private Triple<TreePath,Boolean,Point> scrollToMatchingPath(JTree tree, String path)
- scrollToPathToSelect
  
  @RunsInEDT private static Pair<Boolean,Point> scrollToPathToSelect(JTree tree, TreePath path, JTreeLocation location)
- scrollToTreePath
  
  @RunsInCurrentThread private static Point scrollToTreePath(JTree tree, TreePath path, JTreeLocation location)
- makeParentVisible
  
  @RunsInEDT private boolean makeParentVisible(JTree tree, TreePath path)
- makeVisible
  
  @RunsInEDT private boolean makeVisible(JTree tree, TreePath path, boolean expandWhenFound)
  
  Matches, makes visible, and expands the path one component at a time, from uppermost ancestor on down, since children may be lazily loaded/created.
  
  Parameters:
  
  tree - the target JTree.
  
  path - the tree path to make visible.
  
  expandWhenFound - indicates if nodes should be expanded or not when found.
  
  Returns:
  
  if it was necessary to make visible and/or expand a node in the path.
- waitForChildrenToShowUp
  
  @RunsInEDT private void waitForChildrenToShowUp(JTree tree, TreePath path)
- requireSelection
  
  @RunsInEDT public void requireSelection(JTree tree, int[] rows)
  
  Asserts that the given JTree's selected rows are equal to the given one.
  
  Parameters:
  
  tree - the target JTree.
  
  rows - the indices of the rows, expected to be selected.
  
  Throws:
  
  NullPointerException - if the array of row indices is null.
  
  AssertionError - if the given JTree selection is not equal to the given rows.
- requireSelection
  
  @RunsInEDT public void requireSelection(JTree tree, String[] paths)
  
  Asserts that the given JTree's selected paths are equal to the given one.
  Parameters:
  
  tree - the target JTree.
  
  paths - the given paths, expected to be selected.
  
  Throws:
  
  NullPointerException - if the array of paths is null.
  
  LocationUnavailableException - if any of the given paths cannot be found.
  
  AssertionError - if the given JTree selection is not equal to the given paths.
  
  See Also:
  
  separator(String)
- requireNoSelection
  
  @RunsInEDT public void requireNoSelection(JTree tree)
  
  Asserts that the given JTree does not have any selection.
  
  Parameters:
  
  tree - the given JTree.
  
  Throws:
  
  AssertionError - if the JTree has a selection.
- selectionProperty
  
  @RunsInEDT private org.fest.assertions.Description selectionProperty(JTree tree)
- requireEditable
  
  @RunsInEDT public void requireEditable(JTree tree)
  
  Asserts that the given JTree is editable.
  
  Parameters:
  
  tree - the given JTree.
  
  Throws:
  
  AssertionError - if the JTree is not editable.
- requireNotEditable
  
  @RunsInEDT public void requireNotEditable(JTree tree)
  
  Asserts that the given JTree is not editable.
  
  Parameters:
  
  tree - the given JTree.
  
  Throws:
  
  AssertionError - if the JTree is editable.
- assertEditable
  
  @RunsInEDT private void assertEditable(JTree tree, boolean editable)
- editableProperty
  
  @RunsInEDT private static org.fest.assertions.Description editableProperty(JTree tree)
- separator
  
  public String separator()
  
  Returns the separator to use when converting TreePaths to Strings.
  
  Returns:
  
  the separator to use when converting TreePaths to Strings.
- separator
  
  public void separator(String newSeparator)
  
  Updates the separator to use when converting TreePaths to Strings.
  
  Parameters:
  
  newSeparator - the new separator.
  
  Throws:
  
  NullPointerException - if the given separator is null.
- cellReader
  
  public void cellReader(JTreeCellReader newCellReader)
  
  Updates the implementation of JTreeCellReader to use when comparing internal values of a JTree and the values expected in a test.
  
  Parameters:
  
  newCellReader - the new JTreeCellValueReader to use.
  
  Throws:
  
  NullPointerException - if newCellReader is null.
- validateRow
  
  @RunsInEDT public void validateRow(JTree tree, int row)
  
  Verifies that the given row index is valid.
  
  Parameters:
  
  tree - the given JTree.
  
  row - the given index.
  
  Throws:
  
  IndexOutOfBoundsException - if the given index is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  Since:
  
  1.2
- validatePath
  
  @RunsInEDT public void validatePath(JTree tree, String path)
  
  Verifies that the given node path exists.
  
  Parameters:
  
  tree - the given JTree.
  
  path - the given path.
  
  Throws:
  
  LocationUnavailableException - if the given path cannot be found.
  
  Since:
  
  1.2
- nodeValue
  
  @RunsInEDT public String nodeValue(JTree tree, String path)
  
  Returns the String representation of the node at the given path.
  
  Parameters:
  
  tree - the given JTree.
  
  path - the given path.
  
  Returns:
  
  the String representation of the node at the given path.
  
  Throws:
  
  LocationUnavailableException - if the given path cannot be found.
  
  Since:
  
  1.2
- nodeValue
  
  public String nodeValue(JTree tree, int row)
  
  Returns the String representation of the node at the given row index.
  
  Parameters:
  
  tree - the given JTree.
  
  row - the given row.
  
  Returns:
  
  the String representation of the node at the given row index.
  
  Throws:
  
  IndexOutOfBoundsException - if the given row is less than zero or equal than or greater than the number of visible rows in the JTree.
  
  LocationUnavailableException - if a tree path for the given row cannot be found.
  
  Since:
  
  1.2
- cellReader
  
  JTreeCellReader cellReader()

Class JTreeDriver

Field Summary

Fields inherited from class org.fest.swing.driver.ComponentDriver

Constructor Summary

Method Summary

Methods inherited from class org.fest.swing.driver.JComponentDriver

Methods inherited from class org.fest.swing.driver.ContainerDriver

Methods inherited from class org.fest.swing.driver.ComponentDriver

Methods inherited from class java.lang.Object

Field Details

EDITABLE_PROPERTY

SELECTION_PROPERTY

location

pathFinder

Constructor Details

JTreeDriver

Method Details

clickRow

clickRow

clickRow

clickRow

doubleClickRow

rightClickRow

scrollToRow

clickPath

clickPath

validateIsNotNull

clickPath

validateIsNotNull

clickPath

doubleClickPath

scrollToPath

doubleClick

rightClickPath

rightClick

expandRow

collapseRow

toggleRow

scrollToRowAndGetToggleInfo

expandPath

collapsePath

scrollToMatchingPathAndGetToggleInfo

toggleCell

toggleRowThroughTreeUI

selectRows

validateRows

clearSelection

selectRow

selectPaths

validatePaths

selectPath

showPopupMenu

showPopupMenu

drag

scrollAndSelectRow

drop

scrollToRow

scrollToVisible

drag

selectMatchingPath

drop

scrollToMatchingPath

scrollToPathToSelect

scrollToTreePath

makeParentVisible

makeVisible

waitForChildrenToShowUp

requireSelection

requireSelection

requireNoSelection

selectionProperty

requireEditable

requireNotEditable

assertEditable

editableProperty

separator

separator

cellReader

validateRow

validatePath