GUITestCase (Student Library Documentation)

java.lang.Object
- junit.framework.Assert
- - junit.framework.TestCase
  - - student.TestCase
    - - student.GUITestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

GraphicTestCase, ObjectdrawTestCase
```
public class GUITestCase
extends TestCase
```
This class provides enhancements to TestCase to support testing of custom Swing components, panels, and main programs with graphical user interfaces (GUIs). GUI testing support is based on abbot's testing infrastructure, and works equally well for Swing and/or AWT components.

Version:

$Revision: 1.15 $, $Date: 2011/06/09 15:29:58 $

Author:

Stephen Edwards, Last changed by $Author: stedwar2 $

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

protected static class GUITestCase.EventDispatchException
Represents an exception that occurred on the event dispatch thread.
- Nested classes/interfaces inherited from class student.TestCase
  TestCase.AssertMethodCalledIncorrectly

Nested Classes
Modifier and Type	Class and Description
`protected static class`	`GUITestCase.EventDispatchException` Represents an exception that occurred on the event dispatch thread.

Field Summary

Fields
Modifier and Type	Field and Description
`protected static Class<?>[]`	`DISPOSE_CLASSES` Any member data derived from these classes will be automatically set to `null` after the test has run.
`GUIFilter.Operator`	`where` This field re-exports the `where` operator from `GUIFilter` so that it is available in test methods without requiring a static import.

Constructor Summary

Constructors
Constructor and Description

GUITestCase()
Creates a new GUITestCase object.

GUITestCase(String name)
Creates a new GUITestCase object.

Constructors
Constructor and Description
`GUITestCase()` Creates a new GUITestCase object.
`GUITestCase(String name)` Creates a new GUITestCase object.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<T> T`	`callGUIIOMethod(Object receiver, Class<T> returnType, String methodName, Object... params)` Call a method that involves window-based I/O, so that the method is executed on the GUI event thread, and return its value.
`void`	`callGUIIOMethod(Object reciever, String methodName, Object... params)` Call a method that involves window-based I/O, so that the method is executed on the GUI event thread.
`void`	`callGUIIOMethod(Runnable r)` A more primitive version of `callGUIIOMethod()` that takes a `Runnable` instead of a receiver, method name, and parameters.
`void`	`click(Component component)` Left-click on the center of the component (mouse button 1 press and release).
`void`	`click(Component component, int x, int y)` Left-click at the given location on a component (mouse button 1 press and release).
`void`	`click(Component component, int x, int y, int buttons, int count)` Click on a component, specifying the location, specific mouse buttons, and click count.
`void`	`clickDialogButton(String buttonText)` Assuming that a Dialog of some sort is currently open, this method clicks the specified button.
`protected abbot.finder.Hierarchy`	`createHierarchy()` Create the component hierarchy object that will be used in this test class.
`void`	`doubleClick(Component component)` Left-double-click on the center of the component (mouse button 1 press and release twice).
`void`	`doubleClick(Component component, int x, int y)` Left-double-click at the given location on a component (mouse button 1 press and release twice).
`void`	`enterText(JTextComponent component, String text)` Type the given text into the given component, replacing any existing text already there.
`protected void`	`fixtureSetUp()` Ensure proper test harness setup that won't be inadvertently overridden by a derived class.
`protected void`	`fixtureTearDown()` Handles restoration of system state.
`void`	`focus(Component component)` Give the focus to a specific component.
`<T extends Component> List<T>`	`getAllComponentsMatching(Class<T> type)` Look up all components in the GUI being tested by specifying their class.
`<T extends Component> List<T>`	`getAllComponentsMatching(Class<T> type, GUIFilter filter)` Look up all components in the GUI being tested by specifying their class and a `GUIFilter`.
`List<Component>`	`getAllComponentsMatching(GUIFilter filter)` Look up all components in the GUI being tested by specifying a `GUIFilter`.
`<T extends Component> T`	`getComponent(Class<T> type)` Look up a component in the GUI being tested by specifying its class.
`<T extends Component> T`	`getComponent(Class<T> type, GUIFilter filter)` Look up a component in the GUI being tested by specifying its class and a `GUIFilter`.
`<T extends Component> T`	`getComponent(Class<T> type, String name)` Look up a component in the GUI being tested by specifying its class and its name (as returned by the component's `getName()` method).
`Component`	`getComponent(GUIFilter filter)` Look up a component in the GUI being tested, using a filter to specify which component you want.
`List<String>`	`getContents(JComboBox component)` Get the contents of a combo box, in the form of a list of strings.
`List<String>`	`getContents(JList component)` Get the contents of a list control, in the form of a list of strings.
`protected abbot.finder.ComponentFinder`	`getFinder()` Obtain a component finder to look up components.
`<T extends Component> T`	`getFirstComponentMatching(Class<T> type)` Look up a component in the GUI being tested by specifying its class.
`<T extends Component> T`	`getFirstComponentMatching(Class<T> type, GUIFilter filter)` Look up a component in the GUI being tested by specifying its class and a `GUIFilter`.
`Component`	`getFirstComponentMatching(GUIFilter filter)` Look up a component in the GUI being tested by specifying a `GUIFilter`.
`protected abbot.finder.Hierarchy`	`getHierarchy()` Get the hierarchy used by finders in this test class.
`String`	`getPathFor(Component component)` Get the hierarchical path to the given component, starting from the outermost component in which it is contained, e.g., "JFrame:JRootPane:JPanel:JButton".
`protected abbot.tester.Robot`	`getRobot()` Return an Abbot `Robot` for basic event generation.
`protected abbot.tester.WindowTracker`	`getWindowTracker()` Return a WindowTracker instance.
`void`	`keyPress(Component component, int keyCode)` Send a single key press (key down action) to a component.
`void`	`keyRelease(Component component, int keyCode)` Send a single key release (key up action) to a component.
`void`	`keyString(Component component, String sequence)` Type a sequence of characters on the given component, where the contents are specified as a string.
`void`	`keyStroke(Component component, int keyCode)` Send a single keystroke to a component.
`void`	`keyStroke(Component component, int keyCode, int modifiers)` Send a single keystroke to a component.
`void`	`mouseDragFrom(Component component, int x, int y)` Initiate a drag action at a specific location on a component.
`void`	`mouseDragFrom(Component component, int x, int y, int buttons)` Initiate a drag action at a specific location on a component, with a specified mouse button.
`void`	`mouseDragOver(Component component, int x, int y)` Drag the currently dragged object over the given location on the specified component.
`void`	`mouseDropOn(Component destination)` End a drag operation currently in progress by "dropping" at the in the center of the specified component.
`void`	`mouseDropOn(Component destination, int x, int y)` End a drag operation currently in progress by "dropping" at the specified coordinates on the given component.
`void`	`mouseExit(Component component)` Move the mouse pointer out of the given component.
`void`	`mouseMove(Component component, int x, int y)` Move the mouse pointer to the given location on the specified component.
`void`	`mousePress(Component component, int x, int y)` Press the left mouse button at the given location on a component (mouse button 1).
`void`	`mousePress(Component component, int x, int y, int buttons)` Press one or more mouse buttons at the given location on a component.
`void`	`mouseRelease()` Release any currently held mouse buttons.
`static GUIFilter`	`not(GUIFilter otherFilter)` The "not" operator for negating an existing filter, when the not operation is at the very beginning of the expression, re-exported from `GUIFilter` so that it is available in test methods without requiring a static import.
`void`	`rightClick(Component component)` Right-click on the center of the component (mouse button 3 press and release).
`void`	`rightClick(Component component, int x, int y)` Right-click at the given location on a component (mouse button 3 press and release).
`void`	`runBare()`
`protected void`	`runTestMethod(Statement statement)` Hook into the custom test execution machinery provided by MixRunner to ensure proper test harness setup and tear down that won't likely be accidentally overridden by a derived class.
`void`	`selectColorInChooser(Color color)` Assuming that a JColorChooser is currently open, chooses the given color and closes the JColorChooser
`void`	`selectFileInChooser(String fileName)` Assuming that a JFileChoosers is currently open, selects the given file and closes the JFileChooser
`void`	`selectFilesInChooser(String... files)` Assuming that a JFileChoosers is currently open, selects the given files and closes the JFileChooser
`void`	`selectItem(JComboBox component, String item)` Select a specific item in a combo box or selection list.
`void`	`selectItem(JList component, String item)` Select a specific item in a selection list.
`void`	`selectMenuItem(JMenuItem item)` Select a given menu item.
`void`	`setInputDialogText(String text)` Assuming a `JOptionPane` is currently open and waiting for input, this method enters the given text into the pane's text field and then closes the JOptionPane.
`void`	`setModifiers(int modifiers, boolean pressed)` Set any key modifiers for future events.
`void`	`setSwitchFocus(boolean switchFocus)`
`Frame`	`showInFrame(Component component)` Displays a specific component that you wish to test, such as a panel, a custom text field, or some other component, wrapping it in a `Frame`.
`Frame`	`showInFrame(Component component, Dimension size)` Displays a specific component that you wish to test, such as a panel, a custom text field, or some other component, wrapping it in a `Frame` with the size you specify.
`void`	`showWindow(Window window)` Safely display a window with proper EDT synchronization.
`void`	`showWindow(Window window, Dimension size)` Safely display a window with proper EDT synchronization.
`protected void`	`sleep()` Convenience method to sleep for a UI interval (same as getRobot().sleep()).
`String`	`toString(Component c)` A shorter, simpler way to get a human-readable representation of a component.
`String`	`toString(Component[] components)` Get a human-reable representation of an array of components using `toString(Component)`.
`<T extends Component> String`	`toString(List<T> components)` Get a human-readable representation of a List of components using `toString(Component)`.

Methods inherited from class junit.framework.TestCase
assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runTest, setName, toString

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

- Field Detail
  - where
```
public final GUIFilter.Operator where
```
    This field re-exports the where operator from GUIFilter so that it is available in test methods without requiring a static import.
  - DISPOSE_CLASSES
```
protected static final Class<?>[] DISPOSE_CLASSES
```
    Any member data derived from these classes will be automatically set to null after the test has run. This enables GC of said classes without GC of the test itself (the default JUnit runners never release their references to the tests) or requiring explicit null-setting in the TestCase.tearDown() method.
- Constructor Detail
  - GUITestCase
```
public GUITestCase()
```
    Creates a new GUITestCase object.
  - GUITestCase
```
public GUITestCase(String name)
```
    Creates a new GUITestCase object.
    
    Parameters:
    
    name - The name of this test case.
- Method Detail
  - showInFrame
```
public Frame showInFrame(Component component)
```
    Displays a specific component that you wish to test, such as a panel, a custom text field, or some other component, wrapping it in a Frame. The frame's size will be its preferred size. This method will return when the enclosing Frame is showing and ready for input.
    
    Parameters:
    
    component - The component to display.
    
    Returns:
    
    The newly created, visible frame containing the component.
  - showInFrame
```
public Frame showInFrame(Component component,
                         Dimension size)
```
    Displays a specific component that you wish to test, such as a panel, a custom text field, or some other component, wrapping it in a Frame with the size you specify. This method will return when the enclosing Frame is showing and ready for input.
    
    Parameters:
    
    component - The component to display.
    
    size - The desired size of the enclosing frame, or null to use the component's preferred size.
    
    Returns:
    
    The newly created, visible frame containing the component
  - showWindow
```
public void showWindow(Window window)
```
    Safely display a window with proper EDT synchronization. This method blocks until the Window is showing and ready for input.
    
    Parameters:
    
    window - The window to show.
  - showWindow
```
public void showWindow(Window window,
                       Dimension size)
```
    Safely display a window with proper EDT synchronization. This method blocks until the Window is showing and ready for input.
    
    Parameters:
    
    window - The window to show.
    
    size - The desired size of the enclosing frame, or null to use the component's preferred size.
  - setModifiers
```
public void setModifiers(int modifiers,
                         boolean pressed)
```
    Set any key modifiers for future events. This method's effects will be automatically undone at the end of the test.
    
    Parameters:
    
    modifiers - A mask indicating which modifier keys to use.
    
    pressed - Whether the modifiers should be in the pressed state.
  - runTestMethod
```
protected void runTestMethod(Statement statement)
                      throws Throwable
```
    Hook into the custom test execution machinery provided by MixRunner to ensure proper test harness setup and tear down that won't likely be accidentally overridden by a derived class.
    If any exceptions are thrown on the event dispatch thread, they count as errors. They will not, however supersede any failures/errors thrown by the test itself unless thrown prior to the main test failure.
    
    Parameters:
    
    statement - The (JUnit4-style) test method to be executed.
    
    Throws:
    
    Throwable - If any exception occurs in the test case or on the event dispatch thread.
  - runBare
```
public void runBare()
             throws Throwable
```
    Overrides:
    
    runBare in class junit.framework.TestCase
    
    Throws:
    
    Throwable
  - not
```
public static GUIFilter not(GUIFilter otherFilter)
```
    The "not" operator for negating an existing filter, when the not operation is at the very beginning of the expression, re-exported from GUIFilter so that it is available in test methods without requiring a static import. This method is designed to be used in expressions like not(where.enabledIs(true).or.hasFocusIs(true)).
    
    Parameters:
    
    otherFilter - The filter to negate
    
    Returns:
    
    A new filter that represents a combination of the left filter with "NOT otherFilter".
  - getComponent
```
public <T extends Component> T getComponent(Class<T> type)
```
    Look up a component in the GUI being tested by specifying its class. This method expects the given class to identify a unique component, meaning that there should only be one instance of the given class in the entire GUI. This can be useful if, for example, you are trying to retrieve a custom panel object created from a class you only instantiate once.
    If no matching component exists, the test case will fail with an appropriate message. If more than one matching component exists, the test case will fail with an appropriate message. test case failure results).
    
    Type Parameters:
    
    T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.
    
    Parameters:
    
    type - The type (class) of the component you wish to retrieve, and also the way you specify the return type of this method.
    
    Returns:
    
    The single component of the desired type that was found (otherwise, a test case failure results).
    
    See Also:
    
    getFirstComponentMatching(Class), getAllComponentsMatching(Class)
  - getComponent
```
public <T extends Component> T getComponent(Class<T> type,
                                            String name)
```
    Look up a component in the GUI being tested by specifying its class and its name (as returned by the component's getName() method). This method expects the given class and name together to identify a unique component, meaning that there should only be one instance of the given class with the given name in the entire GUI. Normally, that will always be the case, since names are used as unique identifiers for testing purposes.
    If no matching component exists, the test case will fail with an appropriate message. If more than one matching component exists, the test case will fail with an appropriate message. test case failure results).
    
    Type Parameters:
    
    T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.
    
    Parameters:
    
    type - The type (class) of the component you wish to retrieve, and also the way you specify the return type of this method.
    
    name - The name of the desired component
    
    Returns:
    
    The single component matching the criteria specified (otherwise, a test case failure results).
  - getComponent
```
public <T extends Component> T getComponent(Class<T> type,
                                            GUIFilter filter)
```
    Look up a component in the GUI being tested by specifying its class and a GUIFilter. This method expects exactly one component to match your criteria. If no matching component exists, the test case will fail with an appropriate message. If more than one matching component exists, the test case will fail with an appropriate message. test case failure results).
    
    Type Parameters:
    
    T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.
    
    Parameters:
    
    type - The type (class) of the component you wish to retrieve, and also the way you specify the return type of this method.
    
    filter - The search criteria.
    
    Returns:
    
    The single component matching the criteria specified (otherwise, a test case failure results).
    
    See Also:
    
    getFirstComponentMatching(Class,GUIFilter), getAllComponentsMatching(Class,GUIFilter)
  - getComponent
```
public Component getComponent(GUIFilter filter)
```
    Look up a component in the GUI being tested, using a filter to specify which component you want. This method is more general than getComponent(Class,GUIFilter), since no class needs to be specified, but that also means the return type is less specific (it is always Component). This method expects the given filter to identify a unique component. If no matching component exists, the test case will fail with an appropriate message. If more than one matching component exists, the test case will fail with an appropriate message.
    
    Parameters:
    
    filter - The search criteria.
    
    Returns:
    
    The single component matching the provided filter (otherwise, a test case failure results).
    
    See Also:
    
    getFirstComponentMatching(GUIFilter), getAllComponentsMatching(GUIFilter)
  - getFirstComponentMatching
```
public <T extends Component> T getFirstComponentMatching(Class<T> type)
```
    Look up a component in the GUI being tested by specifying its class. This method expects the given class to identify at least one such component. If no matching component exists, the test case will fail with an appropriate message. If more than one matching component exists, the first one found will be returned (although client code should not expect a specific search order).
    
    Type Parameters:
    
    T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.
    
    Parameters:
    
    type - The type (class) of the component you wish to retrieve, and also the way you specify the return type of this method.
    
    Returns:
    
    The first component of the desired type that was found (a test case failure results if there are none).
    
    See Also:
    
    getComponent(Class), getAllComponentsMatching(Class)
  - getFirstComponentMatching
```
public <T extends Component> T getFirstComponentMatching(Class<T> type,
                                                         GUIFilter filter)
```
    Look up a component in the GUI being tested by specifying its class and a GUIFilter. This method expects the given criteria to identify at least one such component. If no matching component exists, the test case will fail with an appropriate message. If more than one matching component exists, the first one found will be returned (although client code should not expect a specific search order).
    
    Type Parameters:
    
    T - This method is a template method, and the type T used for the return value is implicitly deduced from the provided argument type.
    
    Parameters:
    
    type - The type (class) of the component you wish to retrieve, and also the way you specify the return type of this method.
    
    filter - The search criteria.
    
    Returns:
    
    The first component that was found matching the criteria specified (a test case failure results if there are none).
    
    See Also:
    
    getComponent(Class,GUIFilter), getAllComponentsMatching(Class,GUIFilter)
  - getFirstComponentMatching
```
public Component getFirstComponentMatching(GUIFilter filter)
```
    Look up a component in the GUI being tested by specifying a GUIFilter. This method is more general than getFirstComponentMatching(Class,GUIFilter), since no class needs to be specified, but that also means the return type is less specific (it is always Component). This method expects the given criteria to identify at least one such component. If no matching component exists, the test case will fail with an appropriate message. If more than one matching component exists, the first one found will be returned (although client code should not expect a specific search order).
    
    Parameters:
    
    filter - The search criteria.
    
    Returns:
    
    The first component that was found matching the criteria specified (a test case failure results if there are none).
    
    See Also:
    
    getComponent(GUIFilter), getAllComponentsMatching(GUIFilter)
  - getAllComponentsMatching
```
public <T extends Component> List<T> getAllComponentsMatching(Class<T> type)
```
    Look up all components in the GUI being tested by specifying their class. All matching objects are returned in a list.
    
    Type Parameters:
    
    T - This method is a template method, and the type T used as the List element type in the return value is implicitly deduced from the provided argument type.
    
    Parameters:
    
    type - The type (class) of the components you wish to retrieve, and also the way you specify the type of elements in the list returned by this method.
    
    Returns:
    
    A list of all components of the desired type that were found. This will be an empty list (not null) if no matching components are found.
    
    See Also:
    
    getComponent(Class), getFirstComponentMatching(Class)
  - getAllComponentsMatching
```
public <T extends Component> List<T> getAllComponentsMatching(Class<T> type,
                                                              GUIFilter filter)
```
    Look up all components in the GUI being tested by specifying their class and a GUIFilter. All matching objects are returned in a list.
    
    Type Parameters:
    
    T - This method is a template method, and the type T used as the List element type in the return value is implicitly deduced from the provided argument type.
    
    Parameters:
    
    type - The type (class) of the components you wish to retrieve, and also the way you specify the type of elements in the list returned by this method.
    
    filter - The search criteria.
    
    Returns:
    
    A list of all components found matching the criteria specified. This will be an empty list (not null) if no matching components are found.
    
    See Also:
    
    getComponent(Class,GUIFilter), getAllComponentsMatching(Class,GUIFilter)
  - getAllComponentsMatching
```
public List<Component> getAllComponentsMatching(GUIFilter filter)
```
    Look up all components in the GUI being tested by specifying a GUIFilter. All matching objects are returned in a list. This method is more general than getAllComponentsMatching(Class,GUIFilter), since no class needs to be specified, but that also means the return type is less specific (it is always List<Component>).
    
    Parameters:
    
    filter - The search criteria.
    
    Returns:
    
    A list of all components found matching the criteria specified. This will be an empty list (not null) if no matching components are found.
    
    See Also:
    
    getComponent(GUIFilter), getAllComponentsMatching(GUIFilter)
  - click
```
public void click(Component component)
```
    Left-click on the center of the component (mouse button 1 press and release).
    
    Parameters:
    
    component - The component to click on.
  - click
```
public void click(Component component,
                  int x,
                  int y)
```
    Left-click at the given location on a component (mouse button 1 press and release). Coordinates are specified relative to the component being clicked.
    
    Parameters:
    
    component - The component to click on.
    
    x - The x-coordinate of the click location.
    
    y - The y-coordinate of the click location.
  - doubleClick
```
public void doubleClick(Component component)
```
    Left-double-click on the center of the component (mouse button 1 press and release twice).
    
    Parameters:
    
    component - The component to click on.
  - doubleClick
```
public void doubleClick(Component component,
                        int x,
                        int y)
```
    Left-double-click at the given location on a component (mouse button 1 press and release twice). Coordinates are specified relative to the component being clicked.
    
    Parameters:
    
    component - The component to click on.
    
    x - The x-coordinate of the click location.
    
    y - The y-coordinate of the click location.
  - rightClick
```
public void rightClick(Component component)
```
    Right-click on the center of the component (mouse button 3 press and release).
    
    Parameters:
    
    component - The component to click on.
  - rightClick
```
public void rightClick(Component component,
                       int x,
                       int y)
```
    Right-click at the given location on a component (mouse button 3 press and release). Coordinates are specified relative to the component being clicked.
    
    Parameters:
    
    component - The component to click on.
    
    x - The x-coordinate of the click location.
    
    y - The y-coordinate of the click location.
  - click
```
public void click(Component component,
                  int x,
                  int y,
                  int buttons,
                  int count)
```
    Click on a component, specifying the location, specific mouse buttons, and click count. Coordinates are specified relative to the component being clicked.
    
    Parameters:
    
    component - The component to click on.
    
    x - The x-coordinate of the click location.
    
    y - The y-coordinate of the click location.
    
    buttons - The button mask indicating which button(s) are being clicked. Use InputEvent constants (just like in a mouse listener) to identify which button(s) to click simultaneously.
    
    count - The number of clicks for this event (single, double, more ...).
  - mousePress
```
public void mousePress(Component component,
                       int x,
                       int y)
```
    Press the left mouse button at the given location on a component (mouse button 1). Coordinates are specified relative to the component being clicked.
    
    Parameters:
    
    component - The component to press the mouse button on.
    
    x - The x-coordinate of the click location.
    
    y - The y-coordinate of the click location.
  - mousePress
```
public void mousePress(Component component,
                       int x,
                       int y,
                       int buttons)
```
    Press one or more mouse buttons at the given location on a component. Coordinates are specified relative to the component being clicked.
    
    Parameters:
    
    component - The component to press the mouse button on.
    
    x - The x-coordinate of the click location.
    
    y - The y-coordinate of the click location.
    
    buttons - The button mask indicating which button(s) are being clicked. Use InputEvent constants (just like in a mouse listener) to identify which button(s) to click simultaneously.
  - mouseRelease
```
public void mouseRelease()
```
    Release any currently held mouse buttons.
  - mouseMove
```
public void mouseMove(Component component,
                      int x,
                      int y)
```
    Move the mouse pointer to the given location on the specified component. Note that a mouseEntered event will be automatically generated as well, if the mouse was not already over the specified component before the move. Further, if the mouse is already inside the component and the coordinates specified lie outside it, a mouseExited event will be generated automatically.
    
    Parameters:
    
    component - The component to move the mouse button on.
    
    x - The x-coordinate of the destination.
    
    y - The y-coordinate of the destination.
  - mouseExit
```
public void mouseExit(Component component)
```
    Move the mouse pointer out of the given component. This is achieved by moving the mouse to (width + 1, height + 1) relative to the component, forcing a mouseExited event to be generated. This might also cause a mouseEntered event in a surrounding or neighboring component--use mouseMove() with other specific coordinates if you want a different effect.
    
    Parameters:
    
    component - The component to exit from.
  - mouseDragFrom
```
public void mouseDragFrom(Component component,
                          int x,
                          int y)
```
    Initiate a drag action at a specific location on a component.
    
    Parameters:
    
    component - The component to begin the drag from
    
    x - The x-coordinate for the mouse press that initiates the drag, which is specified relative to the component.
    
    y - The y-coordinate for the mouse press that initiates the drag, which is specified relative to the component.
  - mouseDragFrom
```
public void mouseDragFrom(Component component,
                          int x,
                          int y,
                          int buttons)
```
    Initiate a drag action at a specific location on a component, with a specified mouse button.
    
    Parameters:
    
    component - The component to begin the drag from
    
    x - The x-coordinate for the mouse press that initiates the drag, which is specified relative to the component.
    
    y - The y-coordinate for the mouse press that initiates the drag, which is specified relative to the component.
    
    buttons - The button mask indicating which button(s) are pressed to initiate this mouse drag action. Use InputEvent constants (just like in a mouse listener) to identify which button(s) to press simultaneously.
  - mouseDragOver
```
public void mouseDragOver(Component component,
                          int x,
                          int y)
```
    Drag the currently dragged object over the given location on the specified component. Use this method to simulate intermediate parts of a drag--that is, movements after the drag has started (via startDragFrom()) and before the "drop" (mouse release).
    
    Parameters:
    
    component - The component to drag over.
    
    x - The x-coordinate of the location to drag over, relative to the given component.
    
    y - The y-coordinate of the location to drag over, relative to the given component.
  - mouseDropOn
```
public void mouseDropOn(Component destination)
```
    End a drag operation currently in progress by "dropping" at the in the center of the specified component. This operation presumes you have already started dragging using startDragFrom(). Calling this method implicitly causes a mouseMoved event to get to the center of the given component, followed by a mouse release of whatever mouse buttons are currently pressed as part of the drag operation that was in progress.
    
    Parameters:
    
    destination - The component to drop on.
  - mouseDropOn
```
public void mouseDropOn(Component destination,
                        int x,
                        int y)
```
    End a drag operation currently in progress by "dropping" at the specified coordinates on the given component. This operation presumes you have already started dragging using startDragFrom(). Calling this method implicitly causes a mouseMoved event to get to the specified coordinates, followed by a mouse release of whatever mouse buttons are currently pressed as part of the drag operation that was in progress.
    
    Parameters:
    
    destination - The component to drop on.
    
    x - The x-coordinate of the drop location, relative to the given destination.
    
    y - The y-coordinate of the drop location, relative to the given destination.
  - focus
```
public void focus(Component component)
```
    Give the focus to a specific component.
    
    Parameters:
    
    component - The component to receive focus.
  - enterText
```
public void enterText(JTextComponent component,
                      String text)
```
    Type the given text into the given component, replacing any existing text already there. If the empty string or null is given, then this method simply removes all existing text.
    
    Parameters:
    
    component - The component to enter text on.
    
    text - The text to enter on the component.
  - keyStroke
```
public void keyStroke(Component component,
                      int keyCode)
```
    Send a single keystroke to a component. A keystroke consists of a key press/key release, with no modifiers.
    
    Parameters:
    
    component - The component that will receive the keystroke--focus will be automatically given to this component first, before the keystroke.
    
    keyCode - The keystroke to send. Use the KeyEvent VK_* constants.
  - keyStroke
```
public void keyStroke(Component component,
                      int keyCode,
                      int modifiers)
```
    Send a single keystroke to a component. A keystroke consists of a key press/key release, with the specified modifiers.
    
    Parameters:
    
    component - The component that will receive the keystroke--focus will be automatically given to this component first, before the keystroke.
    
    keyCode - The keystroke to send. Use the KeyEvent VK_* constants.
    
    modifiers - The keyboard modifier keys to press simultaneously (e.g., shift, control, etc.). For modifiers, use the InputEvent modifier mask constants.
  - keyPress
```
public void keyPress(Component component,
                     int keyCode)
```
    Send a single key press (key down action) to a component.
    
    Parameters:
    
    component - The component that will receive the key press--focus will be automatically given to this component first, before the key is pressed.
    
    keyCode - The key to press. Use the KeyEvent VK_* constants.
  - keyRelease
```
public void keyRelease(Component component,
                       int keyCode)
```
    Send a single key release (key up action) to a component.
    
    Parameters:
    
    component - The component that will receive the key release--focus will be automatically given to this component first, before the key is released.
    
    keyCode - The key to release. Use the KeyEvent VK_* constants.
  - keyString
```
public void keyString(Component component,
                      String sequence)
```
    Type a sequence of characters on the given component, where the contents are specified as a string. This method will send the events required to generate the given string on the given component.
    
    Parameters:
    
    component - The component to type on (or to). It will receive focus first, if necessary.
    
    sequence - The content to type on the component.
  - selectItem
```
public void selectItem(JComboBox component,
                       String item)
```
    Select a specific item in a combo box or selection list.
    
    Parameters:
    
    component - The combo box to select from.
    
    item - The item to select.
  - selectItem
```
public void selectItem(JList component,
                       String item)
```
    Select a specific item in a selection list.
    
    Parameters:
    
    component - The list to select from.
    
    item - The item to select.
  - getContents
```
public List<String> getContents(JComboBox component)
```
    Get the contents of a combo box, in the form of a list of strings.
    
    Parameters:
    
    component - The combo box.
    
    Returns:
    
    The component's contents as a list (never null).
  - getContents
```
public List<String> getContents(JList component)
```
    Get the contents of a list control, in the form of a list of strings.
    
    Parameters:
    
    component - The list.
    
    Returns:
    
    The component's contents as a list (never null).
  - selectMenuItem
```
public void selectMenuItem(JMenuItem item)
```
    Select a given menu item.
    
    Parameters:
    
    item - The menu item to select.
  - getPathFor
```
public String getPathFor(Component component)
```
    Get the hierarchical path to the given component, starting from the outermost component in which it is contained, e.g., "JFrame:JRootPane:JPanel:JButton".
    
    Parameters:
    
    component - The component
    
    Returns:
    
    A string representation of the given component's location in the component hierarchy.
  - toString
```
public String toString(Component c)
```
    A shorter, simpler way to get a human-readable representation of a component. The toString() method on Component prints a huge amount of information, and ironically often makes it difficult to understand exactly which component you've printed. This version of toString() prints only the component's class, name, and hash code.
    
    Parameters:
    
    c - The component
    
    Returns:
    
    A string representation of the component of the form JButton[button1, 6546787].
  - toString
```
public String toString(Component[] components)
```
    Get a human-reable representation of an array of components using toString(Component).
    
    Parameters:
    
    components - The array
    
    Returns:
    
    A string representation of the array of the form (JButton[button1, 6546787], JTextField[input, 6881863]).
  - toString
```
public <T extends Component> String toString(List<T> components)
```
    Get a human-readable representation of a List of components using toString(Component).
    
    Type Parameters:
    
    T - This method is a template method, and the type T is implicitly deduced from the type of elements in the provided List argument. It represents the specific subtype of Component in the List.
    
    Parameters:
    
    components - The list
    
    Returns:
    
    A string representation of the list of the form (JButton[button1, 6546787], JTextField[input, 6881863]).
  - callGUIIOMethod
```
public void callGUIIOMethod(Object reciever,
                            String methodName,
                            Object... params)
```
    Call a method that involves window-based I/O, so that the method is executed on the GUI event thread. This version is intended for calling void methods that do not return any results.
    
    Parameters:
    
    reciever - The object to which the method belongs.
    
    methodName - The name of the method to call.
    
    params - A list of zero or more parameters to pass to the method.
  - callGUIIOMethod
```
public <T> T callGUIIOMethod(Object receiver,
                             Class<T> returnType,
                             String methodName,
                             Object... params)
```
    Call a method that involves window-based I/O, so that the method is executed on the GUI event thread, and return its value. This version is intended for calling methods that have a non-void return type.
    
    Type Parameters:
    
    T - This method is a template method, and the type T is implicitly deduced from the returnType argument.
    
    Parameters:
    
    receiver - The object to which the method belongs.
    
    returnType - The expected type of the method's return value.
    
    methodName - The name of the method to call.
    
    params - A list of zero or more parameters to pass to the method.
    
    Returns:
    
    The return value of the method.
  - callGUIIOMethod
```
public void callGUIIOMethod(Runnable r)
```
    A more primitive version of callGUIIOMethod() that takes a Runnable instead of a receiver, method name, and parameters. Students should use one of the other versions instead.
    
    Parameters:
    
    r - The runnable to invoke.
  - selectFileInChooser
```
public void selectFileInChooser(String fileName)
```
    Assuming that a JFileChoosers is currently open, selects the given file and closes the JFileChooser
    
    Parameters:
    
    fileName - the name of the file to choose
  - selectFilesInChooser
```
public void selectFilesInChooser(String... files)
```
    Assuming that a JFileChoosers is currently open, selects the given files and closes the JFileChooser
    
    Parameters:
    
    fileName - the name of the file to choose
  - selectColorInChooser
```
public void selectColorInChooser(Color color)
```
    Assuming that a JColorChooser is currently open, chooses the given color and closes the JColorChooser
    
    Parameters:
    
    color - the color to choose in the JColorChooser
  - clickDialogButton
```
public void clickDialogButton(String buttonText)
```
    Assuming that a Dialog of some sort is currently open, this method clicks the specified button.
    
    Parameters:
    
    buttonText - The text on the button to click.
  - setInputDialogText
```
public void setInputDialogText(String text)
```
    Assuming a JOptionPane is currently open and waiting for input, this method enters the given text into the pane's text field and then closes the JOptionPane.
    
    Parameters:
    
    text - The text to enter into the JOptionPane.
  - setSwitchFocus
```
public void setSwitchFocus(boolean switchFocus)
```
  - getRobot
```
protected abbot.tester.Robot getRobot()
```
    Return an Abbot Robot for basic event generation.
    
    Returns:
    
    the robot used for this test
  - getWindowTracker
```
protected abbot.tester.WindowTracker getWindowTracker()
```
    Return a WindowTracker instance.
    
    Returns:
    
    the window tracker for this test
  - sleep
```
protected void sleep()
```
    Convenience method to sleep for a UI interval (same as getRobot().sleep()).
  - fixtureSetUp
```
protected void fixtureSetUp()
```
    Ensure proper test harness setup that won't be inadvertently overridden by a derived class.
  - fixtureTearDown
```
protected void fixtureTearDown()
```
    Handles restoration of system state. Automatically disposes of any Components used in the test.
  - getFinder
```
protected abbot.finder.ComponentFinder getFinder()
```
    Obtain a component finder to look up components.
    
    Returns:
    
    a component finder for this test class.
  - createHierarchy
```
protected abbot.finder.Hierarchy createHierarchy()
```
    Create the component hierarchy object that will be used in this test class. This method allows derived classes to provide their own Hierarchy if necessary.
    
    Returns:
    
    A new hierarchy object for use in this test class.
  - getHierarchy
```
protected abbot.finder.Hierarchy getHierarchy()
```
    Get the hierarchy used by finders in this test class.
    
    Returns:
    
    The hierarchy currently in use

Class GUITestCase

Nested Class Summary

Nested classes/interfaces inherited from class student.TestCase

Field Summary

Constructor Summary

Method Summary

Methods inherited from class student.TestCase

Methods inherited from class junit.framework.TestCase

Methods inherited from class java.lang.Object

Field Detail

where

DISPOSE_CLASSES

Constructor Detail

GUITestCase

GUITestCase

Method Detail

showInFrame

showInFrame

showWindow

showWindow

setModifiers

runTestMethod

runBare

not

getComponent

getComponent

getComponent

getComponent

getFirstComponentMatching

getFirstComponentMatching

getFirstComponentMatching

getAllComponentsMatching

getAllComponentsMatching

getAllComponentsMatching

click

click

doubleClick

doubleClick

rightClick

rightClick

click

mousePress

mousePress

mouseRelease

mouseMove

mouseExit

mouseDragFrom

mouseDragFrom

mouseDragOver

mouseDropOn

mouseDropOn

focus

enterText

keyStroke

keyStroke

keyPress

keyRelease

keyString

selectItem

selectItem

getContents

getContents

selectMenuItem

getPathFor

toString

toString

toString

callGUIIOMethod

callGUIIOMethod

callGUIIOMethod

selectFileInChooser

selectFilesInChooser

selectColorInChooser

clickDialogButton

setInputDialogText

setSwitchFocus

getRobot

getWindowTracker

sleep

fixtureSetUp