org.eclipse.jubula.rc.swing.swing.implclasses
Class JTableImplClass

java.lang.Object
  extended by org.eclipse.jubula.rc.swing.swing.implclasses.AbstractSwingImplClass
      extended by org.eclipse.jubula.rc.swing.swing.implclasses.JTableImplClass
All Implemented Interfaces:
org.eclipse.jubula.rc.common.implclasses.IBaseImplementationClass, IImplementationClass

public class JTableImplClass
extends AbstractSwingImplClass

This class implements actions on the Swing JTable.

Created:
23.03.2005

Field Summary
 
Fields inherited from class org.eclipse.jubula.rc.swing.swing.implclasses.AbstractSwingImplClass
INDEX_LIST_SEP_CHAR, POS_UNI_PERCENT, POS_UNIT_PIXEL, RENDERER_FALLBACK_TEXT_GETTER_METHOD_1, RENDERER_FALLBACK_TEXT_GETTER_METHOD_2, VALUE_SEPARATOR
 
Constructor Summary
JTableImplClass()
           
 
Method Summary
 void gdClick(int count, int button)
          Tries to click in the cell under the mouse position.
 void gdDragCell(int mouseButton, java.lang.String modifier, int row, int col, int xPos, java.lang.String xUnits, int yPos, java.lang.String yUnits)
          Deprecated. Will be removed with gdDragCell with String parameter for Row/Column
 void gdDragCell(int mouseButton, java.lang.String modifier, java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator, int xPos, java.lang.String xUnits, int yPos, java.lang.String yUnits)
          Drags the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.
 void gdDragCellByColValue(int mouseButton, java.lang.String modifier, int row, java.lang.String value, java.lang.String regex, java.lang.String searchType)
          Deprecated. Will be removed with gdDragCellByColValue with String parameter for Row/Column
 void gdDragCellByColValue(int mouseButton, java.lang.String modifier, java.lang.String row, java.lang.String rowOperator, java.lang.String value, java.lang.String regex, java.lang.String searchType)
          Finds the first column which contains the value value in the given row and drags the cell.
 void gdDragRowByValue(int mouseButton, java.lang.String modifier, int col, java.lang.String value, java.lang.String regexOp, java.lang.String searchType)
          Deprecated. Will be removed with gdDragRowByValue with String parameter for Row/Column
 void gdDragRowByValue(int mouseButton, java.lang.String modifier, java.lang.String col, java.lang.String colOperator, java.lang.String value, java.lang.String regexOp, java.lang.String searchType)
          Finds the first row which contains the value value in column col and drags this row.
 void gdDropCell(int row, int col, int xPos, java.lang.String xUnits, int yPos, java.lang.String yUnits, int delayBeforeDrop)
          Deprecated. Will be removed with gdDropCell with String parameter for Row/Column
 void gdDropCell(java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator, int xPos, java.lang.String xUnits, int yPos, java.lang.String yUnits, int delayBeforeDrop)
          Drops on the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.
 void gdDropCellByColValue(int row, java.lang.String value, java.lang.String regex, java.lang.String searchType, int delayBeforeDrop)
          Deprecated. Will be removed with gdDropCellByColValue with String parameter for Row/Column
 void gdDropCellByColValue(java.lang.String row, java.lang.String rowOperator, java.lang.String value, java.lang.String regex, java.lang.String searchType, int delayBeforeDrop)
          Finds the first column which contains the value value in the given row and drops on the cell.
 void gdDropRowByValue(int col, java.lang.String value, java.lang.String regexOp, java.lang.String searchType, int delayBeforeDrop)
          Deprecated. Will be removed with gdDropRowByValue with String parameter for Row/Column
 void gdDropRowByValue(java.lang.String col, java.lang.String colOperator, java.lang.String value, java.lang.String regexOp, java.lang.String searchType, int delayBeforeDrop)
          Finds the first row which contains the value value in column col and drops on this row.
 void gdInputText(java.lang.String text)
          Writes the passed text into the currently selected cell.
 void gdInputText(java.lang.String text, int row, int col)
          Deprecated. Will be removed with gdInputText with String parameter for Row/Column
 void gdInputText(java.lang.String text, java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator)
          Types the text in the specified cell.
 void gdMove(java.lang.String direction, int cellCount, int clickCount, int xPos, java.lang.String xUnits, int yPos, java.lang.String yUnits, java.lang.String extendSelection)
          Selects a cell relative to the cell at the current mouse position.
 void gdPopupByIndexPathAtCell(int row, int col, java.lang.String indexPath)
          Deprecated. Will be made private. For internal use only!
 void gdPopupByIndexPathAtSelectedCell(java.lang.String indexPath)
          Deprecated. will be removed!
 void gdPopupByTextPathAtCell(int row, int col, java.lang.String textPath)
          Deprecated. Will be made private. For internal use only!
 void gdPopupByTextPathAtSelectedCell(java.lang.String textPath)
          Deprecated. will be removed!
 java.lang.String gdReadValue(java.lang.String variable)
          Action to read the value of the current selected cell of the JTable to store it in a variable in the Client
 java.lang.String gdReadValue(java.lang.String variable, int row, int col)
          Deprecated. Will be removed with gdReadValue with String parameter for Row/Column
 java.lang.String gdReadValue(java.lang.String variable, java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator)
          Action to read the value of the passed cell of the JTable to store it in a variable in the Client
 java.lang.String gdReadValueAtMousePosition(java.lang.String variable)
          
 void gdReplaceText(java.lang.String text)
          Types text into the component.
 void gdReplaceText(java.lang.String text, int row, int col)
          Deprecated. Will be removed with gdReplaceText with String parameter for Row/Column
 void gdReplaceText(java.lang.String text, java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator)
          Replaces the given text in the given cell coordinates
 void gdSelectCell(int row, int col, int clickCount, int xPos, java.lang.String xUnits, int yPos, java.lang.String yUnits, java.lang.String extendSelection)
          Deprecated. Will be removed with gdSelectCell with String parameter for Row/Column
 void gdSelectCell(java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator, int clickCount, int xPos, java.lang.String xUnits, int yPos, java.lang.String yUnits, java.lang.String extendSelection, int button)
          Selects the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.
 void gdSelectCellByColValue(int row, java.lang.String value, java.lang.String regex, int clickCount, java.lang.String extendSelection, java.lang.String searchType)
          Deprecated. Will be removed with gdSelectCellByColValue with String parameter for Row/Column
protected  void gdSelectCellByColValue(int row, java.lang.String value, java.lang.String regex, java.lang.String extendSelection, java.lang.String searchType, int clickCount)
          Deprecated. Will be removed with gdSelectCellByColValue with String parameter for Row/Column
 void gdSelectCellByColValue(java.lang.String row, java.lang.String rowOperator, java.lang.String value, java.lang.String regex, int clickCount, java.lang.String extendSelection, java.lang.String searchType, int button)
          Finds the first column which contains the value value in the given row and selects the cell.
protected  void gdSelectCellByColValue(java.lang.String row, java.lang.String rowOperator, java.lang.String value, java.lang.String regex, java.lang.String extendSelection, java.lang.String searchType, org.eclipse.jubula.rc.common.driver.ClickOptions co)
          Finds the first column which contains the value value in the given row and selects the cell.
 void gdSelectCellByRowValue(int col, java.lang.String value, boolean regex)
          Deprecated. the same as gdSelectRowByValue Will be removed!
 void gdSelectRow(int row, java.lang.String extendSelection)
          Deprecated. the same as gdSelectCell Will be removed!
 void gdSelectRowByValue(int col, java.lang.String value, int clickCount, java.lang.String regexOp, java.lang.String extendSelection, java.lang.String searchType)
          Deprecated. Will be removed with gdSelectRowByValue with String parameter for Row/Column
protected  void gdSelectRowByValue(int col, java.lang.String value, java.lang.String regexOp, java.lang.String extendSelection, java.lang.String searchType, int clickCount)
          Deprecated. Will be removed with gdSelectRowByValue with String parameter for Row/Column
 void gdSelectRowByValue(java.lang.String col, java.lang.String colOperator, java.lang.String value, java.lang.String regexOp, int clickCount, java.lang.String extendSelection, java.lang.String searchType, int button)
          Finds the first row which contains the value value in column col and selects this row.
protected  void gdSelectRowByValue(java.lang.String col, java.lang.String colOperator, java.lang.String value, java.lang.String regexOp, java.lang.String extendSelection, java.lang.String searchType, org.eclipse.jubula.rc.common.driver.ClickOptions co)
          Finds the first row which contains the value value in column col and selects this row.
 void gdVerifyEditable(boolean editable)
          Verifies the editable property of the current selected cell.
 void gdVerifyEditable(boolean editable, int row, int col)
          Deprecated. Will be removed with gdVerifyEditable with String parameter for Row/Column
 void gdVerifyEditable(boolean editable, java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator)
          Verifies the editable property of the given indices.
 void gdVerifyEditableMousePosition(boolean editable)
          Verifies the editable property of the cell under current mouse position.
 void gdVerifyEditableSelected(boolean editable)
          Verifies the editable property of the selected cell.
 void gdVerifyText(java.lang.String text)
          Verifies the rendered text inside the currently selected cell.
 void gdVerifyText(java.lang.String text, java.lang.String operator)
          Verifies the rendered text inside the currently selected cell.
 void gdVerifyText(java.lang.String text, java.lang.String operator, int row, int col)
          Deprecated. Will be removed with gdVerifyText with String parameter for Row/Column
 void gdVerifyText(java.lang.String text, java.lang.String operator, java.lang.String row, java.lang.String rowOperator, java.lang.String col, java.lang.String colOperator)
          Verifies the rendered text inside the passed cell.
 void gdVerifyTextAtMousePosition(java.lang.String text, java.lang.String operator)
          Verifies the rendered text inside cell at the mouse position on screen.
 void gdVerifyValueInColumn(java.lang.String col, java.lang.String colOperator, java.lang.String value, java.lang.String operator, java.lang.String searchType, boolean exists)
          Verifies, if value exists in column.
 void gdVerifyValueInRow(java.lang.String row, java.lang.String rowOperator, java.lang.String value, java.lang.String operator, java.lang.String searchType, boolean exists)
          Verifies, if value exists in row.
protected  org.eclipse.jubula.rc.common.implclasses.table.Cell getCellAtMousePosition()
           
protected  java.lang.String getCellText(int row, int col)
           
 javax.swing.JComponent getComponent()
          
protected  java.lang.String getText()
          Get a String representation of the "text" of the component.
 java.lang.String[] getTextArrayFromComponent()
          Returns a descriptive text array that represents the given gui component.
 void setComponent(java.lang.Object graphicsComponent)
          Set the component the methods this implementation class implements have to work with.
protected  javax.swing.JPopupMenu showPopup(int button)
          Shows and returns the popup menu
 
Methods inherited from class org.eclipse.jubula.rc.swing.swing.implclasses.AbstractSwingImplClass
gdClickDirect, gdDrag, gdDrop, gdPopupSelectByIndexPath, gdPopupSelectByIndexPath, gdPopupSelectByIndexPath, gdPopupSelectByIndexPath, gdPopupSelectByTextPath, gdPopupSelectByTextPath, gdPopupSelectByTextPath, gdPopupSelectByTextPath, gdPopupVerifyEnabledByIndexPath, gdPopupVerifyEnabledByIndexPath, gdPopupVerifyEnabledByTextPath, gdPopupVerifyEnabledByTextPath, gdPopupVerifyExistsByIndexPath, gdPopupVerifyExistsByIndexPath, gdPopupVerifyExistsByTextPath, gdPopupVerifyExistsByTextPath, gdPopupVerifySelectedByIndexPath, gdPopupVerifySelectedByIndexPath, gdPopupVerifySelectedByTextPath, gdPopupVerifySelectedByTextPath, gdShowText, gdStorePropertyValue, gdVerifyEnabled, gdVerifyExists, gdVerifyFocus, gdVerifyProperty, gdWaitForComponent, getClickModifier, getEventThreadQueuer, getRenderedText, getRenderedText, getRobot, getRobotFactory, hasFocus, highLight, lowLight, pressOrReleaseModifiers, resolveRenderedText, verify
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

JTableImplClass

public JTableImplClass()
Method Detail

setComponent

public void setComponent(java.lang.Object graphicsComponent)
Set the component the methods this implementation class implements have to work with.
The methods are declared by the configuration file for supported components.

Parameters:
graphicsComponent - the component from the AUT
Notice: Every changes made to control affects the AUT.

getComponent

public javax.swing.JComponent getComponent()

Specified by:
getComponent in class AbstractSwingImplClass
Returns:
The component passed to the implementation class by calling IBaseImplementationClass.setComponent(Object)

getCellAtMousePosition

protected org.eclipse.jubula.rc.common.implclasses.table.Cell getCellAtMousePosition()
                                                                              throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Returns:
the cell under the current mouse position.
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If no cell is found.

gdSelectCell

public void gdSelectCell(java.lang.String row,
                         java.lang.String rowOperator,
                         java.lang.String col,
                         java.lang.String colOperator,
                         int clickCount,
                         int xPos,
                         java.lang.String xUnits,
                         int yPos,
                         java.lang.String yUnits,
                         java.lang.String extendSelection,
                         int button)
                  throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Selects the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.

Parameters:
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator
clickCount - The number of clicks with the right mouse button
xPos - what x position
xUnits - should x position be pixel or percent values
yPos - what y position
yUnits - should y position be pixel or percent values
extendSelection - Should this selection be part of a multiple selection
button - what mouse button should be used
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid

gdSelectCell

public void gdSelectCell(int row,
                         int col,
                         int clickCount,
                         int xPos,
                         java.lang.String xUnits,
                         int yPos,
                         java.lang.String yUnits,
                         java.lang.String extendSelection)
                  throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Deprecated. Will be removed with gdSelectCell with String parameter for Row/Column

Selects the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.

Parameters:
row - The row of the cell.
col - The column of the cell.
clickCount - The number of clicks with the right mouse button
xPos - what x position
xUnits - should x position be pixel or percent values
yPos - what y position
yUnits - should y position be pixel or percent values
extendSelection - Should this selection be part of a multiple selection
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid

gdMove

public void gdMove(java.lang.String direction,
                   int cellCount,
                   int clickCount,
                   int xPos,
                   java.lang.String xUnits,
                   int yPos,
                   java.lang.String yUnits,
                   java.lang.String extendSelection)
            throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Selects a cell relative to the cell at the current mouse position. If the mouse is not at any cell, the current selected cell is used.

Parameters:
direction - the direction to move.
cellCount - the amount of cells to move
clickCount - the click count to select the new cell.
xPos - what x position
xUnits - should x position be pixel or percent values
yPos - what y position
yUnits - should y position be pixel or percent values
extendSelection - Should this selection be part of a multiple selection
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - if any error occurs

gdSelectRow

public void gdSelectRow(int row,
                        java.lang.String extendSelection)
                 throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Deprecated. the same as gdSelectCell Will be removed!

Selects the passed row of the JTable. This is actually a selection of the cell (row, 0).

Parameters:
row - The row
extendSelection - Should this selection be part of a multiple selection
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row is invalid

gdVerifyText

public void gdVerifyText(java.lang.String text,
                         java.lang.String operator,
                         java.lang.String row,
                         java.lang.String rowOperator,
                         java.lang.String col,
                         java.lang.String colOperator)
                  throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Verifies the rendered text inside the passed cell.

Parameters:
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator
text - The cell text to verify.
operator - The operation used to verify
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid, or if the rendered text cannot be extracted.

gdVerifyText

public void gdVerifyText(java.lang.String text,
                         java.lang.String operator,
                         int row,
                         int col)
                  throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Deprecated. Will be removed with gdVerifyText with String parameter for Row/Column

Verifies the rendered text inside the passed cell.

Parameters:
row - The row of the cell.
col - The column of the cell.
text - The cell text to verify.
operator - The operation used to verify
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid, or if the rendered text cannot be extracted.

getCellText

protected java.lang.String getCellText(int row,
                                       int col)
Parameters:
row - the zero based index of the row
col - the zero based index of the column
Returns:
the text of the cell of the given coordinates

gdVerifyText

public void gdVerifyText(java.lang.String text,
                         java.lang.String operator)
                  throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Verifies the rendered text inside the currently selected cell.

Parameters:
text - The cell text to verify.
operator - The operation used to verify
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If there is no selected cell, or if the rendered text cannot be extracted.

gdVerifyTextAtMousePosition

public void gdVerifyTextAtMousePosition(java.lang.String text,
                                        java.lang.String operator)
                                 throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Verifies the rendered text inside cell at the mouse position on screen.

Parameters:
text - The cell text to verify.
operator - The operation used to verify
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If there is no selected cell, or if the rendered text cannot be extracted.

gdVerifyText

public void gdVerifyText(java.lang.String text)
                  throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Verifies the rendered text inside the currently selected cell.

Parameters:
text - The cell text to verify.
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If there is no selected cell, or if the rendered text cannot be extracted.

gdVerifyValueInRow

public void gdVerifyValueInRow(java.lang.String row,
                               java.lang.String rowOperator,
                               java.lang.String value,
                               java.lang.String operator,
                               java.lang.String searchType,
                               boolean exists)
                        throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Verifies, if value exists in row.

Parameters:
row - The row of the cell.
rowOperator - the row header operator
value - The cell text to verify.
operator - The operation used to verify
searchType - Determines where the search begins ("relative" or "absolute")
exists - true if value exists, false otherwise
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid, or if the rendered text cannot be extracted.

gdVerifyValueInColumn

public void gdVerifyValueInColumn(java.lang.String col,
                                  java.lang.String colOperator,
                                  java.lang.String value,
                                  java.lang.String operator,
                                  java.lang.String searchType,
                                  boolean exists)
                           throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Verifies, if value exists in column.

Parameters:
col - The column of the cell.
colOperator - the column header operator
value - The cell text to verify.
operator - The operation used to verify
searchType - Determines where the search begins ("relative" or "absolute")
exists - true if value exists, false otherwise
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid, or if the rendered text cannot be extracted.

gdVerifyEditable

public void gdVerifyEditable(boolean editable)
Verifies the editable property of the current selected cell.

Parameters:
editable - The editable property to verify.

gdVerifyEditable

public void gdVerifyEditable(boolean editable,
                             java.lang.String row,
                             java.lang.String rowOperator,
                             java.lang.String col,
                             java.lang.String colOperator)
Verifies the editable property of the given indices.

Parameters:
editable - The editable property to verify.
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator

gdVerifyEditable

public void gdVerifyEditable(boolean editable,
                             int row,
                             int col)
Deprecated. Will be removed with gdVerifyEditable with String parameter for Row/Column

Verifies the editable property of the given indices.

Parameters:
editable - The editable property to verify.
row - The table row
col - The table column

gdVerifyEditableSelected

public void gdVerifyEditableSelected(boolean editable)
Verifies the editable property of the selected cell.

Parameters:
editable - the editable property to verify.

gdVerifyEditableMousePosition

public void gdVerifyEditableMousePosition(boolean editable)
Verifies the editable property of the cell under current mouse position.

Parameters:
editable - the editable property to verify.

gdReplaceText

public void gdReplaceText(java.lang.String text)
                   throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Types text into the component. This replaces the shown content in the current selected cell.

Parameters:
text - the text to type in
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If there is no selected cell, or if the cell is not editable, or if the table cell editor permits the text to be written.

gdReplaceText

public void gdReplaceText(java.lang.String text,
                          java.lang.String row,
                          java.lang.String rowOperator,
                          java.lang.String col,
                          java.lang.String colOperator)
Replaces the given text in the given cell coordinates

Parameters:
text - the text to replace
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator

gdReplaceText

public void gdReplaceText(java.lang.String text,
                          int row,
                          int col)
Deprecated. Will be removed with gdReplaceText with String parameter for Row/Column

Replaces the given text in the given cell coordinates

Parameters:
text - the text to replace
row - the row
col - the column

gdInputText

public void gdInputText(java.lang.String text)
                 throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Writes the passed text into the currently selected cell.

Parameters:
text - The text.
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If there is no selected cell, or if the cell is not editable, or if the table cell editor permits the text to be written.

gdInputText

public void gdInputText(java.lang.String text,
                        java.lang.String row,
                        java.lang.String rowOperator,
                        java.lang.String col,
                        java.lang.String colOperator)
                 throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Types the text in the specified cell.

Parameters:
text - The text
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the text input fails

gdInputText

public void gdInputText(java.lang.String text,
                        int row,
                        int col)
                 throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Deprecated. Will be removed with gdInputText with String parameter for Row/Column

Types the text in the specified cell.

Parameters:
text - The text
row - The table row
col - The table column
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the text input fails

gdClick

public void gdClick(int count,
                    int button)
Tries to click in the cell under the mouse position. If the mouse is not over a cell, the current selected cell will be clicked on. If there is no selected cell, the middle of the table is used to click on.

Overrides:
gdClick in class AbstractSwingImplClass
Parameters:
count - Number of clicks
button - The mouse button

gdSelectRowByValue

public void gdSelectRowByValue(java.lang.String col,
                               java.lang.String colOperator,
                               java.lang.String value,
                               java.lang.String regexOp,
                               int clickCount,
                               java.lang.String extendSelection,
                               java.lang.String searchType,
                               int button)
Finds the first row which contains the value value in column col and selects this row.

Parameters:
col - the column to select
colOperator - the column header operator
value - the value
regexOp - the regex operator
clickCount - the number of clicks
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")
button - what mouse button should be used

gdSelectRowByValue

public void gdSelectRowByValue(int col,
                               java.lang.String value,
                               int clickCount,
                               java.lang.String regexOp,
                               java.lang.String extendSelection,
                               java.lang.String searchType)
Deprecated. Will be removed with gdSelectRowByValue with String parameter for Row/Column

Finds the first row which contains the value value in column col and selects this row.

Parameters:
col - the column
value - the value
clickCount - the number of clicks
regexOp - the regex operator
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")

gdSelectRowByValue

protected void gdSelectRowByValue(java.lang.String col,
                                  java.lang.String colOperator,
                                  java.lang.String value,
                                  java.lang.String regexOp,
                                  java.lang.String extendSelection,
                                  java.lang.String searchType,
                                  org.eclipse.jubula.rc.common.driver.ClickOptions co)
Finds the first row which contains the value value in column col and selects this row.

Parameters:
col - the column
colOperator - the column header operator
value - the value
regexOp - the regex operator
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")
co - the clickOptions to use

gdSelectRowByValue

protected void gdSelectRowByValue(int col,
                                  java.lang.String value,
                                  java.lang.String regexOp,
                                  java.lang.String extendSelection,
                                  java.lang.String searchType,
                                  int clickCount)
Deprecated. Will be removed with gdSelectRowByValue with String parameter for Row/Column

Finds the first row which contains the value value in column col and selects this row.

Parameters:
col - the column
value - the value
regexOp - the regex operator
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")
clickCount - the clickCount

gdSelectCellByColValue

public void gdSelectCellByColValue(java.lang.String row,
                                   java.lang.String rowOperator,
                                   java.lang.String value,
                                   java.lang.String regex,
                                   int clickCount,
                                   java.lang.String extendSelection,
                                   java.lang.String searchType,
                                   int button)
Finds the first column which contains the value value in the given row and selects the cell.

Parameters:
row - the row to select
rowOperator - the row header operator
value - the value
clickCount - the number of clicks
regex - search using regex
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")
button - what mouse button should be used

gdSelectCellByColValue

public void gdSelectCellByColValue(int row,
                                   java.lang.String value,
                                   java.lang.String regex,
                                   int clickCount,
                                   java.lang.String extendSelection,
                                   java.lang.String searchType)
Deprecated. Will be removed with gdSelectCellByColValue with String parameter for Row/Column

Finds the first column which contains the value value in the given row and selects the cell.

Parameters:
row - the row
value - the value
clickCount - the number of clicks
regex - search using regex
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")

gdSelectCellByColValue

protected void gdSelectCellByColValue(java.lang.String row,
                                      java.lang.String rowOperator,
                                      java.lang.String value,
                                      java.lang.String regex,
                                      java.lang.String extendSelection,
                                      java.lang.String searchType,
                                      org.eclipse.jubula.rc.common.driver.ClickOptions co)
Finds the first column which contains the value value in the given row and selects the cell.

Parameters:
row - the row
rowOperator - the row header operator
value - the value
regex - search using regex
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")
co - the click options to use

gdSelectCellByColValue

protected void gdSelectCellByColValue(int row,
                                      java.lang.String value,
                                      java.lang.String regex,
                                      java.lang.String extendSelection,
                                      java.lang.String searchType,
                                      int clickCount)
Deprecated. Will be removed with gdSelectCellByColValue with String parameter for Row/Column

Finds the first column which contains the value value in the given row and selects the cell.

Parameters:
row - the row
value - the value
regex - search using regex
extendSelection - Should this selection be part of a multiple selection
searchType - Determines where the search begins ("relative" or "absolute")
clickCount - the number of clicks

gdSelectCellByRowValue

public void gdSelectCellByRowValue(int col,
                                   java.lang.String value,
                                   boolean regex)
Deprecated. the same as gdSelectRowByValue Will be removed!

Finds the first row which contains the value value in the given column and selects the cell.

Parameters:
col - the column
value - the value
regex - search using regex

gdPopupByIndexPathAtCell

public void gdPopupByIndexPathAtCell(int row,
                                     int col,
                                     java.lang.String indexPath)
Deprecated. Will be made private. For internal use only!

Selects a popup menu item at the specified cell

Parameters:
row - row
col - column
indexPath - path of the menu items

gdPopupByTextPathAtCell

public void gdPopupByTextPathAtCell(int row,
                                    int col,
                                    java.lang.String textPath)
Deprecated. Will be made private. For internal use only!

Selects a popup menu item at the specified cell

Parameters:
row - row
col - column
textPath - path of the menu items

gdPopupByIndexPathAtSelectedCell

public void gdPopupByIndexPathAtSelectedCell(java.lang.String indexPath)
Deprecated. will be removed!

Select a popup menu item at the selected cell

Parameters:
indexPath - path of the menu items

gdPopupByTextPathAtSelectedCell

public void gdPopupByTextPathAtSelectedCell(java.lang.String textPath)
Deprecated. will be removed!

Select a popup menu item at the selected cell

Parameters:
textPath - path of the menu items

gdReadValue

public java.lang.String gdReadValue(java.lang.String variable)
Action to read the value of the current selected cell of the JTable to store it in a variable in the Client

Parameters:
variable - the name of the variable
Returns:
the text value.

gdReadValue

public java.lang.String gdReadValue(java.lang.String variable,
                                    java.lang.String row,
                                    java.lang.String rowOperator,
                                    java.lang.String col,
                                    java.lang.String colOperator)
Action to read the value of the passed cell of the JTable to store it in a variable in the Client

Parameters:
variable - the name of the variable
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator
Returns:
the text value.

gdReadValue

public java.lang.String gdReadValue(java.lang.String variable,
                                    int row,
                                    int col)
Deprecated. Will be removed with gdReadValue with String parameter for Row/Column

Action to read the value of the passed cell of the JTable to store it in a variable in the Client

Parameters:
variable - the name of the variable
row - The row of the cell
col - The column of the cell
Returns:
the text value.

gdDragCell

public void gdDragCell(int mouseButton,
                       java.lang.String modifier,
                       java.lang.String row,
                       java.lang.String rowOperator,
                       java.lang.String col,
                       java.lang.String colOperator,
                       int xPos,
                       java.lang.String xUnits,
                       int yPos,
                       java.lang.String yUnits)
                throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Drags the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.

Parameters:
mouseButton - the mouseButton.
modifier - the modifier.
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator
xPos - what x position
xUnits - should x position be pixel or percent values
yPos - what y position
yUnits - should y position be pixel or percent values
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid

gdDragCell

public void gdDragCell(int mouseButton,
                       java.lang.String modifier,
                       int row,
                       int col,
                       int xPos,
                       java.lang.String xUnits,
                       int yPos,
                       java.lang.String yUnits)
                throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Deprecated. Will be removed with gdDragCell with String parameter for Row/Column

Drags the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.

Parameters:
mouseButton - the mouseButton.
modifier - the modifier.
row - The row of the cell.
col - The column of the cell.
xPos - what x position
xUnits - should x position be pixel or percent values
yPos - what y position
yUnits - should y position be pixel or percent values
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid

gdDropCell

public void gdDropCell(java.lang.String row,
                       java.lang.String rowOperator,
                       java.lang.String col,
                       java.lang.String colOperator,
                       int xPos,
                       java.lang.String xUnits,
                       int yPos,
                       java.lang.String yUnits,
                       int delayBeforeDrop)
                throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Drops on the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.

Parameters:
row - the row to select
rowOperator - the row header operator
col - the column to select
colOperator - the column header operator
xPos - what x position
xUnits - should x position be pixel or percent values
yPos - what y position
yUnits - should y position be pixel or percent values
delayBeforeDrop - the amount of time (in milliseconds) to wait between moving the mouse to the drop point and releasing the mouse button
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid

gdDropCell

public void gdDropCell(int row,
                       int col,
                       int xPos,
                       java.lang.String xUnits,
                       int yPos,
                       java.lang.String yUnits,
                       int delayBeforeDrop)
                throws org.eclipse.jubula.rc.common.exception.StepExecutionException
Deprecated. Will be removed with gdDropCell with String parameter for Row/Column

Drops on the cell of the JTable.
With the xPos, yPos, xunits and yUnits the click position inside the cell can be defined.

Parameters:
row - The row of the cell.
col - The column of the cell.
xPos - what x position
xUnits - should x position be pixel or percent values
yPos - what y position
yUnits - should y position be pixel or percent values
delayBeforeDrop - the amount of time (in milliseconds) to wait between moving the mouse to the drop point and releasing the mouse button
Throws:
org.eclipse.jubula.rc.common.exception.StepExecutionException - If the row or the column is invalid

gdDragRowByValue

public void gdDragRowByValue(int mouseButton,
                             java.lang.String modifier,
                             java.lang.String col,
                             java.lang.String colOperator,
                             java.lang.String value,
                             java.lang.String regexOp,
                             java.lang.String searchType)
Finds the first row which contains the value value in column col and drags this row.

Parameters:
mouseButton - the mouse button
modifier - the modifier
col - the column
colOperator - the column header operator
value - the value
regexOp - the regex operator
searchType - Determines where the search begins ("relative" or "absolute")

gdDragRowByValue

public void gdDragRowByValue(int mouseButton,
                             java.lang.String modifier,
                             int col,
                             java.lang.String value,
                             java.lang.String regexOp,
                             java.lang.String searchType)
Deprecated. Will be removed with gdDragRowByValue with String parameter for Row/Column

Finds the first row which contains the value value in column col and drags this row.

Parameters:
mouseButton - the mouse button
modifier - the modifier
col - the column
value - the value
regexOp - the regex operator
searchType - Determines where the search begins ("relative" or "absolute")

gdDropRowByValue

public void gdDropRowByValue(int col,
                             java.lang.String value,
                             java.lang.String regexOp,
                             java.lang.String searchType,
                             int delayBeforeDrop)
Deprecated. Will be removed with gdDropRowByValue with String parameter for Row/Column

Finds the first row which contains the value value in column col and drops on this row.

Parameters:
col - the column
value - the value
regexOp - the regex operator
searchType - Determines where the search begins ("relative" or "absolute")
delayBeforeDrop - the amount of time (in milliseconds) to wait between moving the mouse to the drop point and releasing the mouse button

gdDropRowByValue

public void gdDropRowByValue(java.lang.String col,
                             java.lang.String colOperator,
                             java.lang.String value,
                             java.lang.String regexOp,
                             java.lang.String searchType,
                             int delayBeforeDrop)
Finds the first row which contains the value value in column col and drops on this row.

Parameters:
col - the column to select
colOperator - the column header operator
value - the value
regexOp - the regex operator
searchType - Determines where the search begins ("relative" or "absolute")
delayBeforeDrop - the amount of time (in milliseconds) to wait between moving the mouse to the drop point and releasing the mouse button

gdDragCellByColValue

public void gdDragCellByColValue(int mouseButton,
                                 java.lang.String modifier,
                                 java.lang.String row,
                                 java.lang.String rowOperator,
                                 java.lang.String value,
                                 java.lang.String regex,
                                 java.lang.String searchType)
Finds the first column which contains the value value in the given row and drags the cell.

Parameters:
mouseButton - the mouse button
modifier - the modifiers
row - the row to select
rowOperator - the row header operator
value - the value
regex - search using regex
searchType - Determines where the search begins ("relative" or "absolute")

gdDragCellByColValue

public void gdDragCellByColValue(int mouseButton,
                                 java.lang.String modifier,
                                 int row,
                                 java.lang.String value,
                                 java.lang.String regex,
                                 java.lang.String searchType)
Deprecated. Will be removed with gdDragCellByColValue with String parameter for Row/Column

Finds the first column which contains the value value in the given row and drags the cell.

Parameters:
mouseButton - the mouse button
modifier - the modifiers
row - the row
value - the value
regex - search using regex
searchType - Determines where the search begins ("relative" or "absolute")

gdDropCellByColValue

public void gdDropCellByColValue(java.lang.String row,
                                 java.lang.String rowOperator,
                                 java.lang.String value,
                                 java.lang.String regex,
                                 java.lang.String searchType,
                                 int delayBeforeDrop)
Finds the first column which contains the value value in the given row and drops on the cell.

Parameters:
row - the row to select
rowOperator - the row header operator
value - the value
regex - search using regex
searchType - Determines where the search begins ("relative" or "absolute")
delayBeforeDrop - the amount of time (in milliseconds) to wait between moving the mouse to the drop point and releasing the mouse button

gdDropCellByColValue

public void gdDropCellByColValue(int row,
                                 java.lang.String value,
                                 java.lang.String regex,
                                 java.lang.String searchType,
                                 int delayBeforeDrop)
Deprecated. Will be removed with gdDropCellByColValue with String parameter for Row/Column

Finds the first column which contains the value value in the given row and drops on the cell.

Parameters:
row - the row
value - the value
regex - search using regex
searchType - Determines where the search begins ("relative" or "absolute")
delayBeforeDrop - the amount of time (in milliseconds) to wait between moving the mouse to the drop point and releasing the mouse button

getTextArrayFromComponent

public java.lang.String[] getTextArrayFromComponent()
Returns a descriptive text array that represents the given gui component.
Descriptive texts can be received for example from buttons, labels and table headers. If text is obviously data (for example in text input components) then it is not considered a descriptive text.
If the component has no descriptive text then null, an empty array or an array with length one and null or an empty string as content has to be returned.

Returns:
array containing none, one or many texts representing the
gui component or null

getText

protected java.lang.String getText()
Description copied from class: AbstractSwingImplClass
Get a String representation of the "text" of the component. This String is used in all compare actions and all other places where a simple "as text" view is needed. This has to be replaced either with simple getText() calls on the components or by calls to the cell (or other) renderers of the component using getRenderedText()

Specified by:
getText in class AbstractSwingImplClass
Returns:
the renderer text of the selected cell
See Also:
AbstractSwingImplClass.getText()

gdReadValueAtMousePosition

public java.lang.String gdReadValueAtMousePosition(java.lang.String variable)


showPopup

protected javax.swing.JPopupMenu showPopup(int button)
Shows and returns the popup menu

Overrides:
showPopup in class AbstractSwingImplClass
Parameters:
button - MouseButton
Returns:
the popup menu