org.netbeans.jemmy.operators
Class ListOperator

java.lang.Object
  extended by org.netbeans.jemmy.operators.Operator
      extended by org.netbeans.jemmy.operators.ComponentOperator
          extended by org.netbeans.jemmy.operators.ListOperator
All Implemented Interfaces:
Outputable, Timeoutable

public class ListOperator
extends ComponentOperator
implements Outputable



Timeouts used:
ComponentOperator.WaitComponentTimeout - time to wait component displayed
ComponentOperator.WaitComponentEnabledTimeout - time to wait component enabled
.

Author:
Alexandre Iline (alexandre.iline@sun.com)
See Also:
Timeouts

Nested Class Summary
static class ListOperator.ListByItemFinder
          Allows to find component by item text.
static class ListOperator.ListFinder
          Checks component type.
 
Nested classes/interfaces inherited from class org.netbeans.jemmy.operators.Operator
Operator.ComponentVisualizer, Operator.DefaultPathParser, Operator.DefaultStringComparator, Operator.Finder, Operator.MapAction, Operator.MapBooleanAction, Operator.MapByteAction, Operator.MapCharacterAction, Operator.MapDoubleAction, Operator.MapFloatAction, Operator.MapIntegerAction, Operator.MapLongAction, Operator.MapVoidAction, Operator.NoBlockingAction, Operator.PathParser, Operator.StringComparator
 
Field Summary
static String ITEM_PREFIX_DPROP
          Identifier for a "item" properties.
static String SELECTED_ITEM_PREFIX_DPROP
          Identifier for a "selected item" property.
 
Fields inherited from class org.netbeans.jemmy.operators.ComponentOperator
HEIGHT_DPROP, IS_SHOWING_DPROP, IS_VISIBLE_DPROP, NAME_DPROP, WIDTH_DPROP, X_DPROP, Y_DPROP
 
Fields inherited from class org.netbeans.jemmy.operators.Operator
CLASS_DPROP, TO_STRING_DPROP
 
Constructor Summary
ListOperator(ContainerOperator cont)
          Constructor.
ListOperator(ContainerOperator cont, ComponentChooser chooser)
          Constructs a ListOperator object.
ListOperator(ContainerOperator cont, ComponentChooser chooser, int index)
          Constructs a ListOperator object.
ListOperator(ContainerOperator cont, int index)
          Constructor.
ListOperator(ContainerOperator cont, String text)
          Constructor.
ListOperator(ContainerOperator cont, String text, int index)
          Constructor.
ListOperator(ContainerOperator cont, String text, int itemIndex, int index)
          Constructor.
ListOperator(List b)
          Constructor.
 
Method Summary
 void addActionListener(ActionListener actionListener)
          Maps List.addActionListener(ActionListener) through queue
 void addItemListener(ItemListener itemListener)
          Maps List.addItemListener(ItemListener) through queue
 void copyEnvironment(Operator anotherOperator)
          Copies all environment (output, timeouts, visualizer) from another operator.
 void deselect(int i)
          Maps List.deselect(int) through queue
 int findItemIndex(String item)
          Searches an item index.
 int findItemIndex(String item, int index)
          Searches an item index.
static List findList(Container cont, ComponentChooser chooser)
          Searches 0'th List in container.
static List findList(Container cont, ComponentChooser chooser, int index)
          Searches List in container.
 Hashtable getDump()
          Returns information about component.
 String getItem(int i)
          Maps List.getItem(int) through queue
 int getItemCount()
          Maps List.getItemCount() through queue
 String[] getItems()
          Maps List.getItems() through queue
 Dimension getMinimumSize(int i)
          Maps List.getMinimumSize(int) through queue
 TestOut getOutput()
          Returns print output streams or writers.
 Dimension getPreferredSize(int i)
          Maps List.getPreferredSize(int) through queue
 int getRows()
          Maps List.getRows() through queue
 int getSelectedIndex()
          Maps List.getSelectedIndex() through queue
 int[] getSelectedIndexes()
          Maps List.getSelectedIndexes() through queue
 String getSelectedItem()
          Maps List.getSelectedItem() through queue
 String[] getSelectedItems()
          Maps List.getSelectedItems() through queue
 Object[] getSelectedObjects()
          Maps List.getSelectedObjects() through queue
 int getVisibleIndex()
          Maps List.getVisibleIndex() through queue
 boolean isIndexSelected(int i)
          Maps List.isIndexSelected(int) through queue
 boolean isMultipleMode()
          Maps List.isMultipleMode() through queue
 void makeVisible(int i)
          Maps List.makeVisible(int) through queue
 void remove(int i)
          Maps List.remove(int) through queue
 void remove(String string)
          Maps List.remove(String) through queue
 void removeActionListener(ActionListener actionListener)
          Maps List.removeActionListener(ActionListener) through queue
 void removeAll()
          Maps List.removeAll() through queue
 void removeItemListener(ItemListener itemListener)
          Maps List.removeItemListener(ItemListener) through queue
 void replaceItem(String string, int i)
          Maps List.replaceItem(String, int) through queue
 void select(int i)
          Maps List.select(int) through queue
 void selectItem(int index)
          Selects an item.
 void selectItem(String item)
          Selects an item.
 void selectItem(String item, int index)
          Selects an item.
 void selectItems(int from, int to)
          Selects some items.
 void setMultipleMode(boolean b)
          Maps List.setMultipleMode(boolean) through queue
 void setOutput(TestOut output)
          Defines print output streams or writers.
 void waitItemSelection(int itemIndex, boolean selected)
          Waits for item to be selected.
 void waitItemsSelection(int from, int to, boolean selected)
          Waits for items to be selected.
 
Methods inherited from class org.netbeans.jemmy.operators.ComponentOperator
activateWindow, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, checkImage, checkImage, clickForPopup, clickForPopup, clickForPopup, clickForPopup, clickMouse, clickMouse, clickMouse, clickMouse, clickMouse, clickMouse, clickMouse, contains, contains, createImage, createImage, dispatchEvent, doLayout, dragMouse, dragMouse, dragMouse, dragNDrop, dragNDrop, dragNDrop, enableInputMethods, enterMouse, exitMouse, findComponent, findComponent, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getCenterX, getCenterXForClick, getCenterY, getCenterYForClick, getColorModel, getComponentAt, getComponentAt, getComponentOrientation, getContainer, getContainers, getCursor, getDropTarget, getEventDispatcher, getFocus, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getName, getParent, getPreferredSize, getSize, getSize, getSource, getTimeouts, getToolkit, getTreeLock, getWidth, getWindow, getX, getY, hasFocus, imageUpdate, invalidate, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isShowing, isValid, isVisible, list, list, list, list, list, makeComponentVisible, moveMouse, paint, paintAll, prepareImage, prepareImage, pressKey, pressKey, pressMouse, pressMouse, print, printAll, pushKey, pushKey, releaseKey, releaseKey, releaseMouse, releaseMouse, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFont, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setTimeouts, setVisible, transferFocus, typeKey, typeKey, typeKey, update, validate, waitComponent, waitComponent, waitComponent, waitComponent, waitComponentEnabled, waitComponentShowing, waitComponentVisible, waitHasFocus, wtComponentEnabled
 
Methods inherited from class org.netbeans.jemmy.operators.Operator
addOperatorPackage, addToDump, addToDump, createOperator, getCharBindingMap, getCharKey, getCharModifiers, getCharsKeys, getCharsKeys, getCharsModifiers, getCharsModifiers, getComparator, getDefaultComponentVisualizer, getDefaultMouseButton, getDefaultPathParser, getDefaultStringComparator, getDefaultVerification, getEnvironmentOperator, getParentPath, getParentPath, getPathParser, getPopupMouseButton, getProperties, getQueueTool, getVerification, getVisualizer, isCaptionEqual, isCaptionEqual, isCaptionEqual, lockQueue, parseString, parseString, printDump, produceNoBlocking, produceNoBlocking, produceTimeRestricted, produceTimeRestricted, runMapping, runMapping, runMapping, runMapping, runMapping, runMapping, runMapping, runMapping, runMapping, setCharBindingMap, setComparator, setDefaultComponentVisualizer, setDefaultPathParser, setDefaultStringComparator, setDefaultVerification, setPathParser, setProperties, setVerification, setVisualizer, toStringSource, unlockAndThrow, unlockQueue, waitState
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ITEM_PREFIX_DPROP

public static final String ITEM_PREFIX_DPROP
Identifier for a "item" properties.

See Also:
getDump(), Constant Field Values

SELECTED_ITEM_PREFIX_DPROP

public static final String SELECTED_ITEM_PREFIX_DPROP
Identifier for a "selected item" property.

See Also:
getDump(), Constant Field Values
Constructor Detail

ListOperator

public ListOperator(List b)
Constructor.

Parameters:
b - a component

ListOperator

public ListOperator(ContainerOperator cont,
                    ComponentChooser chooser,
                    int index)
Constructs a ListOperator object.

Parameters:
cont - a container
chooser - a component chooser specifying searching criteria.
index - an index between appropriate ones.

ListOperator

public ListOperator(ContainerOperator cont,
                    ComponentChooser chooser)
Constructs a ListOperator object.

Parameters:
cont - a container
chooser - a component chooser specifying searching criteria.

ListOperator

public ListOperator(ContainerOperator cont,
                    String text,
                    int itemIndex,
                    int index)
Constructor. Waits item text first. Uses cont's timeout and output for waiting and to init operator.

Parameters:
cont - a container
text - Text of item which is currently selected.
itemIndex - Item index.
index - Ordinal component index.
Throws:
TimeoutExpiredException

ListOperator

public ListOperator(ContainerOperator cont,
                    String text,
                    int index)
Constructor. Waits component by selected item text first. Uses cont's timeout and output for waiting and to init operator.

Parameters:
cont - a container
text - Text of item which is currently selected.
index - Ordinal component index.
Throws:
TimeoutExpiredException
See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)

ListOperator

public ListOperator(ContainerOperator cont,
                    String text)
Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.

Parameters:
cont - a container
text - Text of item which is currently selected.
Throws:
TimeoutExpiredException
See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)

ListOperator

public ListOperator(ContainerOperator cont,
                    int index)
Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.

Parameters:
cont - a container
index - Ordinal component index.
Throws:
TimeoutExpiredException

ListOperator

public ListOperator(ContainerOperator cont)
Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.

Parameters:
cont - a container
Throws:
TimeoutExpiredException
Method Detail

findList

public static List findList(Container cont,
                            ComponentChooser chooser,
                            int index)
Searches List in container.

Parameters:
cont - Container to search component in.
chooser - org.netbeans.jemmy.ComponentChooser implementation.
index - Ordinal component index.
Returns:
List instance or null if component was not found.

findList

public static List findList(Container cont,
                            ComponentChooser chooser)
Searches 0'th List in container.

Parameters:
cont - Container to search component in.
chooser - org.netbeans.jemmy.ComponentChooser implementation.
Returns:
List instance or null if component was not found.

setOutput

public void setOutput(TestOut output)
Description copied from interface: Outputable
Defines print output streams or writers.

Specified by:
setOutput in interface Outputable
Overrides:
setOutput in class ComponentOperator
Parameters:
output - Identify the streams or writers used for print output.
See Also:
Outputable.getOutput()

getOutput

public TestOut getOutput()
Description copied from interface: Outputable
Returns print output streams or writers.

Specified by:
getOutput in interface Outputable
Overrides:
getOutput in class ComponentOperator
Returns:
an object that contains references to objects for printing to output and err streams.
See Also:
Outputable.setOutput(org.netbeans.jemmy.TestOut)

copyEnvironment

public void copyEnvironment(Operator anotherOperator)
Description copied from class: Operator
Copies all environment (output, timeouts, visualizer) from another operator.

Overrides:
copyEnvironment in class ComponentOperator
Parameters:
anotherOperator - an operator to copy the environment to.

findItemIndex

public int findItemIndex(String item,
                         int index)
Searches an item index.

Parameters:
item - item text.
index - an ordinal index between appropriate ones.
Returns:
an index.

findItemIndex

public int findItemIndex(String item)
Searches an item index.

Parameters:
item - item text.
Returns:
an index.

selectItem

public void selectItem(String item,
                       int index)
Selects an item.

Parameters:
item - item text.
index - an ordinal index between appropriate ones.

selectItem

public void selectItem(String item)
Selects an item.

Parameters:
item - item text.

selectItem

public void selectItem(int index)
Selects an item.

Parameters:
index - an item index.

selectItems

public void selectItems(int from,
                        int to)
Selects some items.

Parameters:
from - start selection index.
to - end selection index.

waitItemsSelection

public void waitItemsSelection(int from,
                               int to,
                               boolean selected)
Waits for items to be selected.

Parameters:
from - Start selection inex
to - End selection inex
selected - Selected (true) or unselected (false).

waitItemSelection

public void waitItemSelection(int itemIndex,
                              boolean selected)
Waits for item to be selected.

Parameters:
itemIndex - an item index to be selected.
selected - Selected (true) or unselected (false).

getDump

public Hashtable getDump()
Description copied from class: ComponentOperator
Returns information about component.

Overrides:
getDump in class ComponentOperator
Returns:
a Hashtable containing name-value pairs.

addActionListener

public void addActionListener(ActionListener actionListener)
Maps List.addActionListener(ActionListener) through queue


addItemListener

public void addItemListener(ItemListener itemListener)
Maps List.addItemListener(ItemListener) through queue


deselect

public void deselect(int i)
Maps List.deselect(int) through queue


getItem

public String getItem(int i)
Maps List.getItem(int) through queue


getItemCount

public int getItemCount()
Maps List.getItemCount() through queue


getItems

public String[] getItems()
Maps List.getItems() through queue


getMinimumSize

public Dimension getMinimumSize(int i)
Maps List.getMinimumSize(int) through queue


getPreferredSize

public Dimension getPreferredSize(int i)
Maps List.getPreferredSize(int) through queue


getRows

public int getRows()
Maps List.getRows() through queue


getSelectedIndex

public int getSelectedIndex()
Maps List.getSelectedIndex() through queue


getSelectedIndexes

public int[] getSelectedIndexes()
Maps List.getSelectedIndexes() through queue


getSelectedItem

public String getSelectedItem()
Maps List.getSelectedItem() through queue


getSelectedItems

public String[] getSelectedItems()
Maps List.getSelectedItems() through queue


getSelectedObjects

public Object[] getSelectedObjects()
Maps List.getSelectedObjects() through queue


getVisibleIndex

public int getVisibleIndex()
Maps List.getVisibleIndex() through queue


isIndexSelected

public boolean isIndexSelected(int i)
Maps List.isIndexSelected(int) through queue


isMultipleMode

public boolean isMultipleMode()
Maps List.isMultipleMode() through queue


makeVisible

public void makeVisible(int i)
Maps List.makeVisible(int) through queue


remove

public void remove(int i)
Maps List.remove(int) through queue


remove

public void remove(String string)
Maps List.remove(String) through queue


removeActionListener

public void removeActionListener(ActionListener actionListener)
Maps List.removeActionListener(ActionListener) through queue


removeAll

public void removeAll()
Maps List.removeAll() through queue


removeItemListener

public void removeItemListener(ItemListener itemListener)
Maps List.removeItemListener(ItemListener) through queue


replaceItem

public void replaceItem(String string,
                        int i)
Maps List.replaceItem(String, int) through queue


select

public void select(int i)
Maps List.select(int) through queue


setMultipleMode

public void setMultipleMode(boolean b)
Maps List.setMultipleMode(boolean) through queue