Package org.netbeans.jemmy.operators
Class ButtonOperator
- java.lang.Object
-
- org.netbeans.jemmy.operators.Operator
-
- org.netbeans.jemmy.operators.ComponentOperator
-
- org.netbeans.jemmy.operators.ButtonOperator
-
- All Implemented Interfaces:
Outputable
,Timeoutable
public class ButtonOperator extends ComponentOperator implements Timeoutable, Outputable
Timeouts used:
ButtonOperator.PushButtonTimeout - time between button pressing and releasing
ComponentOperator.WaitComponentTimeout - time to wait button displayed
ComponentOperator.WaitComponentEnabledTimeout - time to wait button enabled
.- Author:
- Alexandre Iline (alexandre.iline@sun.com)
- See Also:
Timeouts
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
ButtonOperator.ButtonByLabelFinder
Allows to find component by label.static class
ButtonOperator.ButtonFinder
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
Fields Modifier and Type Field Description static String
TEXT_DPROP
Identifier for a label 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
Constructors Constructor Description ButtonOperator(Button b)
Constructor.ButtonOperator(ContainerOperator cont)
Constructor.ButtonOperator(ContainerOperator cont, int index)
Constructor.ButtonOperator(ContainerOperator cont, String text)
Constructor.ButtonOperator(ContainerOperator cont, String text, int index)
Constructor.ButtonOperator(ContainerOperator cont, ComponentChooser chooser)
Constructs a ButtonOperator object.ButtonOperator(ContainerOperator cont, ComponentChooser chooser, int index)
Constructs a ButtonOperator object.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
addActionListener(ActionListener actionListener)
MapsButton.addActionListener(ActionListener)
through queuevoid
copyEnvironment(Operator anotherOperator)
Copies all environment (output, timeouts, visualizer) from another operator.static Button
findButton(Container cont, String text, boolean ce, boolean ccs)
Searches Button by text.static Button
findButton(Container cont, String text, boolean ce, boolean ccs, int index)
Searches Button by text.static Button
findButton(Container cont, ComponentChooser chooser)
Searches for the first Button in a container.static Button
findButton(Container cont, ComponentChooser chooser, int index)
Searches Button in a container.String
getActionCommand()
MapsButton.getActionCommand()
through queueHashtable
getDump()
Returns information about component.String
getLabel()
MapsButton.getLabel()
through queueTestOut
getOutput()
Returns print output streams or writers.Timeouts
getTimeouts()
Return current timeouts.void
press()
Press the button by mouse.void
push()
Pushes the button by mouse click.void
pushNoBlock()
Runspush()
method in a separate thread.void
release()
Releases the button by mouse.void
removeActionListener(ActionListener actionListener)
MapsButton.removeActionListener(ActionListener)
through queuevoid
setActionCommand(String string)
MapsButton.setActionCommand(String)
through queuevoid
setLabel(String string)
MapsButton.setLabel(String)
through queuevoid
setOutput(TestOut out)
Defines print output streams or writers.void
setTimeouts(Timeouts timeouts)
Defines current timeouts.static Button
waitButton(Container cont, String text, boolean ce, boolean ccs)
Waits Button by text.static Button
waitButton(Container cont, String text, boolean ce, boolean ccs, int index)
Waits Button by text.static Button
waitButton(Container cont, ComponentChooser chooser)
Waits 0'th Button in container.static Button
waitButton(Container cont, ComponentChooser chooser, int index)
Waits Button in container.-
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, 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, 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
-
-
-
-
Field Detail
-
TEXT_DPROP
public static final String TEXT_DPROP
Identifier for a label property.- See Also:
getDump()
, Constant Field Values
-
-
Constructor Detail
-
ButtonOperator
public ButtonOperator(Button b)
Constructor.- Parameters:
b
- Thejava.awt.Button
managed by this instance.
-
ButtonOperator
public ButtonOperator(ContainerOperator cont, ComponentChooser chooser, int index)
Constructs a ButtonOperator object.- Parameters:
cont
- containerchooser
- a component chooser specifying searching criteria.index
- an index between appropriate ones.
-
ButtonOperator
public ButtonOperator(ContainerOperator cont, ComponentChooser chooser)
Constructs a ButtonOperator object.- Parameters:
cont
- containerchooser
- a component chooser specifying searching criteria.
-
ButtonOperator
public ButtonOperator(ContainerOperator cont, String text, int index)
Constructor. Waits for a component in a container to show. The component is identified as theindex+1
'thjava.awt.Button
that shows, lies below the container in the display containment hierarchy, and that has the desired text. Uses cont's timeout and output for waiting and to init this operator.- Parameters:
cont
- The operator for a container containing the sought for button.text
- Button text.index
- Ordinal component index. The first component hasindex
0.- Throws:
TimeoutExpiredException
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
ButtonOperator
public ButtonOperator(ContainerOperator cont, String text)
Constructor. Waits for a component in a container to show. The component is identified as the firstjava.awt.Button
that shows, lies below the container in the display containment hierarchy, and that has the desired text. Uses cont's timeout and output for waiting and to init this operator.- Parameters:
cont
- The operator for a container containing the sought for button.text
- Button text.- Throws:
TimeoutExpiredException
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
ButtonOperator
public ButtonOperator(ContainerOperator cont, int index)
Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.- Parameters:
cont
- The operator for a container containing the sought for button.index
- Ordinal component index.- Throws:
TimeoutExpiredException
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
ButtonOperator
public ButtonOperator(ContainerOperator cont)
Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.- Parameters:
cont
- The operator for a container containing the sought for button.- Throws:
TimeoutExpiredException
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
-
Method Detail
-
findButton
public static Button findButton(Container cont, ComponentChooser chooser, int index)
Searches Button in a container.- Parameters:
cont
- Container in which to search for the component. The container lies above the component in the display containment hierarchy. The containment need not be direct.chooser
- org.netbeans.jemmy.ComponentChooser implementation, defining and applying search criteria.index
- Ordinal component index. The firstindex
is 0.- Returns:
- Button instance or null if component was not found.
-
findButton
public static Button findButton(Container cont, ComponentChooser chooser)
Searches for the first Button in a container.- Parameters:
cont
- Container in which to search for the component. The container lies above the component in the display containment hierarchy. The containment need not be direct.chooser
- org.netbeans.jemmy.ComponentChooser implementation, defining and applying search criteria.- Returns:
- Button instance or null if component was not found.
-
findButton
public static Button findButton(Container cont, String text, boolean ce, boolean ccs, int index)
Searches Button by text.- Parameters:
cont
- Container to search component in.text
- Button text. If null, contents is not checked.ce
- Compare text exactly.ccs
- Compare text case sensitively.index
- Ordinal component index.- Returns:
- Button instance or null if component was not found.
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
findButton
public static Button findButton(Container cont, String text, boolean ce, boolean ccs)
Searches Button by text.- Parameters:
cont
- Container to search component in.text
- Button text. If null, contents is not checked.ce
- Compare text exactly.ccs
- Compare text case sensitively.- Returns:
- Button instance or null if component was not found.
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
waitButton
public static Button waitButton(Container cont, ComponentChooser chooser, int index)
Waits Button in container.- Parameters:
cont
- Container to search component in.chooser
- org.netbeans.jemmy.ComponentChooser implementation.index
- Ordinal component index.- Returns:
- Button instance.
- Throws:
TimeoutExpiredException
-
waitButton
public static Button waitButton(Container cont, ComponentChooser chooser)
Waits 0'th Button in container.- Parameters:
cont
- Container to search component in.chooser
- org.netbeans.jemmy.ComponentChooser implementation.- Returns:
- Button instance.
- Throws:
TimeoutExpiredException
-
waitButton
public static Button waitButton(Container cont, String text, boolean ce, boolean ccs, int index)
Waits Button by text.- Parameters:
cont
- Container to search component in.text
- Button text. If null, contents is not checked.ce
- Compare text exactly.ccs
- Compare text case sensitively.index
- Ordinal component index.- Returns:
- Button instance.
- Throws:
TimeoutExpiredException
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
waitButton
public static Button waitButton(Container cont, String text, boolean ce, boolean ccs)
Waits Button by text.- Parameters:
cont
- Container to search component in.text
- Button text. If null, contents is not checked.ce
- Compare text exactly.ccs
- Compare text case sensitively.- Returns:
- Button instance.
- Throws:
TimeoutExpiredException
- See Also:
Operator.isCaptionEqual(String, String, boolean, boolean)
-
setTimeouts
public void setTimeouts(Timeouts timeouts)
Description copied from interface:Timeoutable
Defines current timeouts.- Specified by:
setTimeouts
in interfaceTimeoutable
- Overrides:
setTimeouts
in classComponentOperator
- Parameters:
timeouts
- A collection of timeout assignments.- See Also:
Timeoutable.getTimeouts()
-
getTimeouts
public Timeouts getTimeouts()
Description copied from interface:Timeoutable
Return current timeouts.- Specified by:
getTimeouts
in interfaceTimeoutable
- Overrides:
getTimeouts
in classComponentOperator
- Returns:
- the collection of current timeout assignments.
- See Also:
Timeoutable.setTimeouts(org.netbeans.jemmy.Timeouts)
-
setOutput
public void setOutput(TestOut out)
Description copied from interface:Outputable
Defines print output streams or writers.- Specified by:
setOutput
in interfaceOutputable
- Overrides:
setOutput
in classComponentOperator
- Parameters:
out
- 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 interfaceOutputable
- Overrides:
getOutput
in classComponentOperator
- 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 classComponentOperator
- Parameters:
anotherOperator
- an operator to copy the environment to.
-
push
public void push()
Pushes the button by mouse click.- Throws:
TimeoutExpiredException
-
pushNoBlock
public void pushNoBlock()
Runspush()
method in a separate thread.
-
press
public void press()
Press the button by mouse.- Throws:
TimeoutExpiredException
-
release
public void release()
Releases the button by mouse.- Throws:
TimeoutExpiredException
-
getDump
public Hashtable getDump()
Returns information about component.- Overrides:
getDump
in classComponentOperator
- Returns:
- a Hashtable containing name-value pairs.
-
addActionListener
public void addActionListener(ActionListener actionListener)
MapsButton.addActionListener(ActionListener)
through queue
-
getActionCommand
public String getActionCommand()
MapsButton.getActionCommand()
through queue
-
getLabel
public String getLabel()
MapsButton.getLabel()
through queue
-
removeActionListener
public void removeActionListener(ActionListener actionListener)
MapsButton.removeActionListener(ActionListener)
through queue
-
setActionCommand
public void setActionCommand(String string)
MapsButton.setActionCommand(String)
through queue
-
setLabel
public void setLabel(String string)
MapsButton.setLabel(String)
through queue
-
-