Interface TreeView

All Superinterfaces:
Element, EnabledProvider, LocationInfoProvider, SupportsNativeObject, TestObject, TestObjectDescriber, WaitUntilEnabledProvider

public interface TreeView extends Element, WaitUntilEnabledProvider
A tree control in a SAP GUI for Windows application.
  • Method Details

    • activateNode

      void activateNode(String path) throws GeneralLeanFtException
      Activates a node in a tree. You can use buildNodePath(Object...) to build the node path string to be used as the path argument for this method. You can also use regular expressions in the path name, using the format: RegExp:=(regular expression).
      Parameters:
      path - the path to the node. Separate nodes in the path can be specified by the name or 1-based index in the format "#index". Elements of the path are separated by semicolons(;).
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • activateNode

      void activateNode(TreeViewNode node) throws GeneralLeanFtException
      Activates a node in a tree.
      Parameters:
      node - the node.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • clickColumn

      void clickColumn(String column) throws GeneralLeanFtException
      Clicks the specified column in a column tree or list tree.
      Parameters:
      column - the name of the column.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • clickColumn

      void clickColumn(int columnIndex) throws GeneralLeanFtException
      Clicks the specified column in a column tree or list tree.
      Parameters:
      columnIndex - 1-based.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • selectNode

      void selectNode(String path) throws GeneralLeanFtException
      Selects a node in an SAP tree. You can use the BuildNodePath method to build the node path string to be used as the path argument for this method. You can also use regular expressions in the path name, using the format: RegExp:=(regular expression).
      Parameters:
      path - the path to the node you want to select. Separate nodes in the path can be specified by the name or index number (in the format "#index") . Index values begin with 1.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • selectNode

      void selectNode(TreeViewNode node) throws GeneralLeanFtException
      Selects a node in an SAP tree.
      Parameters:
      node - the node you want to select.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • openContextMenu

      void openContextMenu() throws GeneralLeanFtException
      Opens a tree's default context menu. After opening a context menu, you can use selectMenuItemById(String) to select the menu item.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • openHeaderContextMenu

      void openHeaderContextMenu(String column) throws GeneralLeanFtException
      Opens a context menu for a header in a column tree or list tree. After opening a context menu, you can use selectMenuItemById(String) to select the menu item.
      Parameters:
      column - the column name.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • openHeaderContextMenu

      void openHeaderContextMenu(int columnIndex) throws GeneralLeanFtException
      Opens a context menu for a header in a column tree or list tree. After opening a context menu, you use selectMenuItemById(String) to select the menu item.
      Parameters:
      columnIndex - the 1-based column index.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • selectMenuItemById

      void selectMenuItemById(String menuItemId) throws GeneralLeanFtException
      Selects a menu item from a context menu by ID.
      Parameters:
      menuItemId - a string format ID for the menu item.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • pressEnter

      void pressEnter() throws GeneralLeanFtException
      Presses the ENTER key. Set focus to to the tree before invoking.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • getSelectedItem

      String getSelectedItem() throws GeneralLeanFtException
      Returns the value of the selected item in the tree.
      Returns:
      the value.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • getSelectedNodePath

      String getSelectedNodePath() throws GeneralLeanFtException
      Returns the path of the selected node in the tree.
      Returns:
      the path of the selected node.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • getSelectionMode

      TreeSelectionMode getSelectionMode() throws GeneralLeanFtException
      Returns which selections can be made in the tree.
      Returns:
      the selection mode.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • getTreeType

      TreeType getTreeType() throws GeneralLeanFtException
      Returns the type of tree.
      Returns:
      the type.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • getNode

      Returns the node with the specified path. If the path is not unique, returns the first node with the specified path. You can use buildNodePath(Object...) to build the node path string to be used as the path argument for this method.
      Parameters:
      path - elements of the path are separated by semicolons(;).
      Returns:
      the node.
      Throws:
      GeneralLeanFtException - if error occurs during execution
    • buildNodePath

      String buildNodePath(Object... nodePathParts) throws GeneralLeanFtException
      Returns the path of the specified tree node.
      Parameters:
      nodePathParts - the node path parts can be: logical name(String), full path(String), or 1-based index(int). Elements of the path are separated by semicolons(;).
      Returns:
      the path.
      Throws:
      GeneralLeanFtException - if error occurs during execution