Open topic with navigation

com.hp.lft.sdk.powerbuilder

## Interface Table

- All Superinterfaces:
    Clickable, DoubleClickable, EnabledProvider, LocationInfoProvider, SupportDragAndDrop, SupportSendKeys, TestObject, TestObjectDescriber, UiObjectBase, UiObjectWithLayoutInfo, VisibleProvider, WaitUntilEnabledProvider, WaitUntilVisibleProvider

      public interface Table
      extends UiObjectWithLayoutInfo, TestObject

  A power builder table.

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `activateCell(int row, int column)` Double-clicks a cell by row and column indexes.
    `void` | `activateCell(int row, String columnHeader)` Double-clicks a cell by row index and column header.
    `String` | `evaluateExpression(String expression, int row)` The EvaluateExpression use Describe method from PowerBuilder to evaluate one expressions involving values of a particular row and column.
    `TableCell` | `getCell(int row, String columnHeader)` Returns a cell specified by row index and column header. ( From LeanFT 14.51)
    `int` | `getColumnCount()`
    `int` | `getRowCount()`
    `List<TableRow>` | `getRows()` Returns the `TableRow` objects in the table.
    `String` | `getTableProperty(String property)` Uses the Describe method from PowerBuilder to return the value of one property of a DataWindow object and controls within the DataWindow object.
    `void` | `selectCell(int row, int column)` Clicks a cell by row and column indexes.
    `void` | `selectCell(int row, String columnHeader)` Clicks a cell by row index and column header.
    `void` | `selectRow(int row)` Selects row by indexes.
    `void` | `selectRow(TableRow row)` Selects row by `TableRow`.

    - ### Methods inherited from interface com.hp.lft.sdk.powerbuilder.UiObjectWithLayoutInfo

      `isRightAligned, isRightToLeftLayout, isRightToLeftReading`

    - ### Methods inherited from interface com.hp.lft.sdk.powerbuilder.UiObjectBase

      `getAttachedText, getObjectName, getText, getWindowClassRegExp, getWindowExtendedStyle, getWindowId, getWindowStyle`

    - ### Methods inherited from interface com.hp.lft.sdk.UiObjectBase

      `getHandle, getNativeClass, getWindowTitleRegExp, isFocused, mouseMove`

    - ### Methods inherited from interface com.hp.lft.sdk.Clickable

      `click, click, click`

    - ### Methods inherited from interface com.hp.lft.sdk.DoubleClickable

      `doubleClick, doubleClick, doubleClick`

    - ### Methods inherited from interface com.hp.lft.sdk.LocationInfoProvider

      `getAbsoluteLocation, getLocation, getSize`

    - ### Methods inherited from interface com.hp.lft.sdk.SupportSendKeys

      `sendKeys, sendKeys`

    - ### Methods inherited from interface com.hp.lft.sdk.SupportDragAndDrop

      `dragAndDropOn, dragAndDropOn`

    - ### Methods inherited from interface com.hp.lft.sdk.WaitUntilEnabledProvider

      `waitUntilEnabled, waitUntilEnabled`

    - ### Methods inherited from interface com.hp.lft.sdk.EnabledProvider

      `isEnabled`

    - ### Methods inherited from interface com.hp.lft.sdk.WaitUntilVisibleProvider

      `waitUntilVisible, waitUntilVisible`

    - ### Methods inherited from interface com.hp.lft.sdk.VisibleProvider

      `isVisible`

    - ### Methods inherited from interface com.hp.lft.sdk.TestObject

      `exists, exists, findChildren, getDescription, getDisplayName, getParent, getSnapshot, getTextLocations, getTextLocations, getVisibleText, getVisibleText, highlight, highlightMatches, setDescription, setDisplayName, verifyImageExists, verifyImageExists, verifyImageMatch, verifyImageMatch, verifyImageMatch, verifyImageMatch, verifyImageMatch, verifyImageMatch, waitUntilExists, waitUntilExists`

    - ### Methods inherited from interface com.hp.lft.sdk.TestObjectDescriber

      `describe`

- - ### Method Detail

    - #### getRows

          List<TableRow> getRows()
                          throws GeneralLeanFtException

      Returns the `TableRow` objects in the table.
      Returns:
        the `TableRow` objects in the table.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### getCell

      Note: Supported in LeanFT versions 14.51 and later.

          TableCell getCell(int row,
          		   String columnHeader)
          	throws GeneralLeanFtException

      Returns a cell specified by row index and column header.
      Parameters:
        `row` - 0-based row index.
        `columnHeader` - the column header.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### getColumnCount

          int getColumnCount()
                      throws GeneralLeanFtException

      Returns:
        The number of columns in the table.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### getRowCount

          int getRowCount()
                   throws GeneralLeanFtException

      Returns:
        The number of rows in the table.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### activateCell

          void activateCell(int row,
                            int column)
                     throws GeneralLeanFtException

      Double-clicks a cell by row and column indexes.
      Parameters:
        `row` - 0-based row index.
        `column` - 0-based column index.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### activateCell

          void activateCell(int row,
                            String columnHeader)
                     throws GeneralLeanFtException

      Double-clicks a cell by row index and column header.
      Parameters:
        `row` - 0-based row index.
        `columnHeader` - the column header.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### selectCell

          void selectCell(int row,
                          int column)
                   throws GeneralLeanFtException

      Clicks a cell by row and column indexes.
      Parameters:
        `row` - 0-based row index.
        `column` - 0-based column index.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### selectCell

          void selectCell(int row,
                          String columnHeader)
                   throws GeneralLeanFtException

      Clicks a cell by row index and column header.
      Parameters:
        `row` - 0-based row index.
        `columnHeader` - the column header.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### selectRow

          void selectRow(int row)
                  throws GeneralLeanFtException

      Selects row by indexes.
      Parameters:
        `row` - 0-based indexes.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### selectRow

          void selectRow(TableRow row)
                  throws GeneralLeanFtException

      Selects row by `TableRow`.
      Parameters:
        `row` - the `TableRow` objects to select.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### getTableProperty

          String getTableProperty(String property)
                           throws GeneralLeanFtException

      Uses the Describe method from PowerBuilder to return the value of one property of a DataWindow object and controls within the DataWindow object. Each column and graphic control in the DataWindow has a set of properties. You specify one property as a string, and GetTableProperty returns the values of the property.
      Parameters:
        `property` - Property name. Possible values: http://infocenter.sybase.com/help/topic/com.sybase.infocenter.dc37783.1252/html/dwref/CCJBHCCF.htm
      Returns:
        Returns a string that includes the value of property. Example: pbTable.getTableProperty("DataWindow.Column.Count"); How to use PowerBuilder Describe method: http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc37783.1252/html/dwref/BFCEADCH.htm The GetTableProperty throws GeneralReplayException for invalid items. The GetTableProperty returns null for property that have no value.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution

    - #### evaluateExpression

          String evaluateExpression(String expression,
                                    int row)
                             throws GeneralLeanFtException

      The EvaluateExpression use Describe method from PowerBuilder to evaluate one expressions involving values of a particular row and column.
      Parameters:
        `expression` - Expression you want to evaluate.
        `row` - The number of the row for which you want to evaluate the expression.
      Returns:
        In the below example EvaluateExpression returns a string with value of 1 or 0 depending on the value of the field1 column and row 2. Example: pbTable.evaluateExpression('If(field1 == 10, 1, 0)', 2); How to use PowerBuilder Describe method to evaluate expression: http://infocenter.sybase.com/help/index.jsp?topic=/com.sybase.infocenter.dc37783.1252/html/dwref/BFCEADCH.htm The EvaluateExpression throws GeneralReplayException for invalid expression.
      Throws:
        `GeneralLeanFtException` - if error occurs during execution