Class JPopupMenuOperator

All Implemented Interfaces:
Outputable, Timeoutable

public class JPopupMenuOperator extends JComponentOperator implements Outputable, Timeoutable


Timeouts used:
JMenuOperator.WaitBeforePopupTimeout - time to sleep before popup expanding
JMenuOperator.WaitPopupTimeout - time to wait popup displayed
ComponentOperator.WaitComponentTimeout - time to wait button displayed
WindowWaiter.WaitWindowTimeout - time to wait popup window displayed
WindowWaiter.AfterWindowTimeout - time to sleep after popup window has been dispayed
.
Author:
Alexandre Iline (alexandre.iline@sun.com)
See Also:
  • Field Details

  • Constructor Details

    • JPopupMenuOperator

      public JPopupMenuOperator(JPopupMenu popup)
      Constructor.
      Parameters:
      popup - a component
    • JPopupMenuOperator

      public JPopupMenuOperator(ContainerOperator cont, ComponentChooser chooser, int index)
      Constructs a JPopupMenuOperator object.
      Parameters:
      cont - a container
      chooser - a component chooser specifying searching criteria.
      index - an index between appropriate ones.
    • JPopupMenuOperator

      public JPopupMenuOperator(ContainerOperator cont, ComponentChooser chooser)
      Constructs a JPopupMenuOperator object.
      Parameters:
      cont - a container
      chooser - a component chooser specifying searching criteria.
    • JPopupMenuOperator

      public JPopupMenuOperator(Operator env)
      Constructor. Waits component first. Constructor can be used in complicated cases when output or timeouts should differ from default.
      Parameters:
      env - an operator to copy environment from.
      Throws:
      TimeoutExpiredException
    • JPopupMenuOperator

      public JPopupMenuOperator(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
    • JPopupMenuOperator

      public JPopupMenuOperator()
      Constructor. Waits component first.
      Throws:
      TimeoutExpiredException
  • Method Details

    • findJPopupMenu

      public static JPopupMenu findJPopupMenu(Container cont, ComponentChooser chooser, int index)
      Searches JPopupMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - a component chooser specifying searching criteria.
      index - Ordinal component index.
      Returns:
      JPopupMenu instance or null if component was not found.
    • findJPopupMenu

      public static JPopupMenu findJPopupMenu(Container cont, ComponentChooser chooser)
      Searches JPopupMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - a component chooser specifying searching criteria.
      Returns:
      JPopupMenu instance or null if component was not found.
    • waitJPopupMenu

      public static JPopupMenu waitJPopupMenu(Container cont, ComponentChooser chooser, int index)
      Waits JPopupMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - a component chooser specifying searching criteria.
      index - Ordinal component index.
      Returns:
      JPopupMenu instance.
      Throws:
      TimeoutExpiredException
    • waitJPopupMenu

      public static JPopupMenu waitJPopupMenu(Container cont, ComponentChooser chooser)
      Waits JPopupMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - a component chooser specifying searching criteria.
      Returns:
      JPopupMenu instance.
      Throws:
      TimeoutExpiredException
    • findJPopupWindow

      public static Window findJPopupWindow(ComponentChooser chooser)
      Searches for a window which contains JPopupMenu.
      Parameters:
      chooser - a component chooser specifying criteria for JPopupMenu.
      Returns:
      a window containing JPopupMenu.
    • waitJPopupWindow

      public static Window waitJPopupWindow(ComponentChooser chooser)
      Waits for a window which contains JPopupMenu.
      Parameters:
      chooser - a component chooser specifying criteria for JPopupMenu.
      Returns:
      a window containing JPopupMenu.
      Throws:
      TimeoutExpiredException
    • waitJPopupMenu

      public static JPopupMenuOperator waitJPopupMenu(ComponentChooser popupChooser)
      Waits popup defined by popupChooser parameter.
      Parameters:
      popupChooser - a component chooser specifying criteria for JPopupMenu.
      Returns:
      a JPopupMenu fitting the criteria.
    • waitJPopupMenu

      public static JPopupMenuOperator waitJPopupMenu(String menuItemText)
      Waits popup containing menu item with menuItemText text.
      Parameters:
      menuItemText - a text of a menu item which supposed to be displayed inside the popup.
      Returns:
      a JPopupMenu fitting the criteria.
    • callPopup

      public static JPopupMenu callPopup(ComponentOperator oper, int x, int y, int mouseButton)
      Calls popup by clicking on (x, y) point in component.
      Parameters:
      oper - Component operator to call popup on.
      x - X coordinate of click point in the component coordinate system.
      y - Y coordinate of click point in the component coordinate system.
      mouseButton - Mouse button mask to call popup.
      Returns:
      an opened JPopupMenu
      Throws:
      TimeoutExpiredException
    • callPopup

      public static JPopupMenu callPopup(ComponentOperator oper, int x, int y)
      Calls popup by clicking on (x, y) point in component.
      Parameters:
      oper - Component operator to call popup on.
      x - X coordinate of click point in the component coordinate system.
      y - Y coordinate of click point in the component coordinate system.
      Returns:
      an opened JPopupMenu
      Throws:
      TimeoutExpiredException
      See Also:
    • callPopup

      public static JPopupMenu callPopup(Component comp, int x, int y, int mouseButton)
      Calls popup by clicking on (x, y) point in component.
      Parameters:
      comp - Component to call popup on.
      x - X coordinate of click point in the component coordinate system.
      y - Y coordinate of click point in the component coordinate system.
      mouseButton - Mouse button mask to call popup.
      Returns:
      an opened JPopupMenu
      Throws:
      TimeoutExpiredException
    • callPopup

      public static JPopupMenu callPopup(Component comp, int x, int y)
      Calls popup by clicking on (x, y) point in component.
      Parameters:
      comp - Component to call popup on.
      x - X coordinate of click point in the component coordinate system.
      y - Y coordinate of click point in the component coordinate system.
      Returns:
      an opened JPopupMenu
      Throws:
      TimeoutExpiredException
      See Also:
    • callPopup

      public static JPopupMenu callPopup(Component comp, int mouseButton)
      Calls popup by clicking component center.
      Parameters:
      comp - Component to call popup on.
      mouseButton - Mouse button mask to call popup.
      Returns:
      an opened JPopupMenu
      Throws:
      TimeoutExpiredException
    • callPopup

      public static JPopupMenu callPopup(Component comp)
      Calls popup by clicking component center.
      Parameters:
      comp - Component to call popup on.
      Returns:
      an opened JPopupMenu
      Throws:
      TimeoutExpiredException
      See Also:
    • setOutput

      public void setOutput(TestOut out)
      Description copied from interface: Outputable
      Defines print output streams or writers.
      Specified by:
      setOutput in interface Outputable
      Overrides:
      setOutput in class JComponentOperator
      Parameters:
      out - Identify the streams or writers used for print output.
      See Also:
    • 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 JComponentOperator
      Returns:
      an object that contains references to objects for printing to output and err streams.
      See Also:
    • setTimeouts

      public void setTimeouts(Timeouts times)
      Description copied from interface: Timeoutable
      Defines current timeouts.
      Specified by:
      setTimeouts in interface Timeoutable
      Overrides:
      setTimeouts in class JComponentOperator
      Parameters:
      times - A collection of timeout assignments.
      See Also:
    • getTimeouts

      public Timeouts getTimeouts()
      Description copied from interface: Timeoutable
      Return current timeouts.
      Specified by:
      getTimeouts in interface Timeoutable
      Overrides:
      getTimeouts in class JComponentOperator
      Returns:
      the collection of current timeout assignments.
      See Also:
    • 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.
    • pushMenu

      public JMenuItem pushMenu(ComponentChooser[] choosers)
      Pushes menu.
      Parameters:
      choosers - Array of choosers to find menuItems to push.
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
    • pushMenuNoBlock

      public void pushMenuNoBlock(ComponentChooser[] choosers)
      Executes pushMenu(choosers) in a separate thread.
      Parameters:
      choosers - Array of choosers to find menuItems to push.
      See Also:
    • pushMenu

      public JMenuItem pushMenu(String[] names, Operator.StringComparator comparator)
      Pushes menu.
      Parameters:
      names - an array of menu texts.
      comparator - a string comparision algorithm
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
    • pushMenu

      public JMenuItem pushMenu(String[] names, boolean ce, boolean ccs)
      Deprecated.
      Use pushMenu(String[]) or pushMenu(String[], StringComparator)
      Pushes menu.
      Parameters:
      names - Menu items texts.
      ce - Compare text exactly.
      ccs - Compare text case sensitively.
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
      See Also:
    • pushMenuNoBlock

      public void pushMenuNoBlock(String[] names, Operator.StringComparator comparator)
      Executes pushMenu(names, ce, ccs) in a separate thread.
      Parameters:
      names - an array of menu texts.
      comparator - a string comparision algorithm
    • pushMenuNoBlock

      public void pushMenuNoBlock(String[] names, boolean ce, boolean ccs)
      Deprecated.
      Use pushMenuNoBlock(String[]) or pushMenuNoBlock(String[], StringComparator)
      Executes pushMenu(names, ce, ccs) in a separate thread.
      Parameters:
      names - Menu items texts.
      ce - Compare text exactly.
      ccs - Compare text case sensitively.
      See Also:
    • pushMenu

      public JMenuItem pushMenu(String[] names)
      Pushes menu.
      Parameters:
      names - Menu items texts.
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
      See Also:
    • pushMenuNoBlock

      public void pushMenuNoBlock(String[] names)
      Executes pushMenu(names) in a separate thread.
      Parameters:
      names - Menu items texts.
      See Also:
    • pushMenu

      public JMenuItem pushMenu(String path, String delim, Operator.StringComparator comparator)
      Pushes menu.
      Parameters:
      path - a menu path.
      delim - a path delimiter.
      comparator - a string comparision algorithm
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
    • pushMenu

      public JMenuItem pushMenu(String path, Operator.StringComparator comparator)
      Pushes menu. Uses PathParser assigned to this operator.
      Parameters:
      path - a menu path.
      comparator - a string comparision algorithm
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
    • pushMenu

      public JMenuItem pushMenu(String path, String delim, boolean ce, boolean ccs)
      Deprecated.
      Use pushMenu(String, String) or pushMenu(String, String, StringComparator)
      Pushes menu.
      Parameters:
      path - String menupath representation ("File/New", for example).
      delim - String menupath divider ("/").
      ce - Compare text exactly.
      ccs - Compare text case sensitively.
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
      See Also:
    • pushMenuNoBlock

      public void pushMenuNoBlock(String path, String delim, Operator.StringComparator comparator)
      Executes pushMenu(names, delim, comparator) in a separate thread.
      Parameters:
      path - a menu path.
      delim - a path delimiter.
      comparator - a string comparision algorithm
    • pushMenuNoBlock

      public void pushMenuNoBlock(String path, Operator.StringComparator comparator)
      Executes pushMenu(names, comparator) in a separate thread. Uses PathParser assigned to this operator.
      Parameters:
      path - a menu path.
      comparator - a string comparision algorithm
    • pushMenuNoBlock

      public void pushMenuNoBlock(String path, String delim, boolean ce, boolean ccs)
      Deprecated.
      Use pushMenuNoBlock(String, String) or pushMenuNoBlock(String, String, StringComparator)
      Executes pushMenu(path, delim, ce, ccs) in a separate thread.
      Parameters:
      path - String menupath representation ("File/New", for example).
      delim - String menupath divider ("/").
      ce - Compare text exactly.
      ccs - Compare text case sensitively.
      See Also:
    • pushMenu

      public JMenuItem pushMenu(String path, String delim)
      Pushes menu.
      Parameters:
      path - String menupath representation ("File/New", for example).
      delim - String menupath divider ("/").
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
    • pushMenu

      public JMenuItem pushMenu(String path)
      Pushes menu. Uses PathParser assigned to this operator.
      Parameters:
      path - String menupath representation ("File/New", for example).
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
    • pushMenuNoBlock

      public void pushMenuNoBlock(String path, String delim)
      Executes pushMenu(path, delim) in a separate thread.
      Parameters:
      path - String menupath representation ("File/New", for example).
      delim - String menupath divider ("/").
    • pushMenuNoBlock

      public void pushMenuNoBlock(String path)
      Executes pushMenu(path) in a separate thread.
      Parameters:
      path - String menupath representation ("File/New", for example).
    • showMenuItems

      public JMenuItemOperator[] showMenuItems(ComponentChooser[] choosers)
    • showMenuItems

      public JMenuItemOperator[] showMenuItems(String[] path, Operator.StringComparator comparator)
      Shows submenu of menu specified by a path parameter.
      Parameters:
      path - an array of menu texts.
      comparator - a string comparision algorithm
      Returns:
      an array of operators created tor items from the submenu.
      Throws:
      TimeoutExpiredException
    • showMenuItems

      public JMenuItemOperator[] showMenuItems(String[] path)
      Shows submenu of menu specified by a path parameter. Uses StringComparator assigned to the operator.
      Parameters:
      path - an array of menu texts.
      Returns:
      an array of operators created tor items from the submenu.
      Throws:
      TimeoutExpiredException
    • showMenuItems

      public JMenuItemOperator[] showMenuItems(String path, String delim, Operator.StringComparator comparator)
      Shows submenu of menu specified by a path parameter.
      Parameters:
      path - a string identifying the menu path.
      delim - a path delimiter.
      comparator - a string comparision algorithm
      Returns:
      an array of operators created tor items from the submenu.
      Throws:
      TimeoutExpiredException
    • showMenuItems

      public JMenuItemOperator[] showMenuItems(String path, Operator.StringComparator comparator)
      Shows submenu of menu specified by a path parameter. Uses PathParser assigned to this operator.
      Parameters:
      path - a string identifying the menu path.
      comparator - a string comparision algorithm
      Returns:
      an array of operators created tor items from the submenu.
      Throws:
      TimeoutExpiredException
    • showMenuItems

      public JMenuItemOperator[] showMenuItems(String path, String delim)
      Shows submenu of menu specified by a path parameter. Uses StringComparator assigned to the operator.
      Parameters:
      path - a string identifying the menu path.
      delim - a path delimiter.
      Returns:
      an array of operators created tor items from the submenu.
      Throws:
      TimeoutExpiredException
    • showMenuItems

      public JMenuItemOperator[] showMenuItems(String path)
      Shows submenu of menu specified by a path parameter. Uses PathParser assigned to this operator. Uses StringComparator assigned to the operator.
      Parameters:
      path - a string identifying the menu path.
      Returns:
      an array of operators created tor items from the submenu.
      Throws:
      TimeoutExpiredException
    • showMenuItem

      public JMenuItemOperator showMenuItem(ComponentChooser[] choosers)
    • showMenuItem

      public JMenuItemOperator showMenuItem(String[] path, Operator.StringComparator comparator)
      Expends all menus to show menu item specified by a path parameter.
      Parameters:
      path - an array of menu texts.
      comparator - a string comparision algorithm
      Returns:
      an operator for the last menu item in path.
      Throws:
      TimeoutExpiredException
    • showMenuItem

      public JMenuItemOperator showMenuItem(String[] path)
      Expands all menus to show menu item specified by a path parameter.
      Parameters:
      path - an array of menu texts.
      Returns:
      an operator for the last menu item in path.
      Throws:
      TimeoutExpiredException
    • showMenuItem

      public JMenuItemOperator showMenuItem(String path, String delim, Operator.StringComparator comparator)
      Expands all menus to show menu item specified by a path parameter.
      Parameters:
      path - a string identifying the menu path.
      delim - a path delimiter.
      comparator - a string comparision algorithm
      Returns:
      an operator for the last menu item in path.
      Throws:
      TimeoutExpiredException
    • showMenuItem

      public JMenuItemOperator showMenuItem(String path, Operator.StringComparator comparator)
      Expands all menus to show menu item specified by a path parameter. Uses PathParser assigned to this operator.
      Parameters:
      path - a string identifying the menu path.
      comparator - a string comparision algorithm
      Returns:
      an operator for the last menu item in path.
      Throws:
      TimeoutExpiredException
    • showMenuItem

      public JMenuItemOperator showMenuItem(String path, String delim)
      Expands all menus to show menu item specified by a path parameter. Uses StringComparator assigned to the operator.
      Parameters:
      path - a string identifying the menu path.
      delim - a path delimiter.
      Returns:
      an operator for the last menu item in path.
      Throws:
      TimeoutExpiredException
    • showMenuItem

      public JMenuItemOperator showMenuItem(String path)
      Expands all menus to show menu item specified by a path parameter. Uses PathParser assigned to this operator. Uses StringComparator assigned to the operator.
      Parameters:
      path - a string identifying the menu path.
      Returns:
      an array of operators created tor items from the submenu.
      Throws:
      TimeoutExpiredException
    • getDump

      public Hashtable getDump()
      Description copied from class: ComponentOperator
      Returns information about component.
      Overrides:
      getDump in class JComponentOperator
      Returns:
      a Hashtable containing name-value pairs.
    • add

      public JMenuItem add(String string)
      Maps JPopupMenu.add(String) through queue
    • add

      public JMenuItem add(Action action)
      Maps JPopupMenu.add(Action) through queue
    • add

      public JMenuItem add(JMenuItem jMenuItem)
      Maps JPopupMenu.add(JMenuItem) through queue
    • addPopupMenuListener

      public void addPopupMenuListener(PopupMenuListener popupMenuListener)
      Maps JPopupMenu.addPopupMenuListener(PopupMenuListener) through queue
    • addSeparator

      public void addSeparator()
      Maps JPopupMenu.addSeparator() through queue
    • getComponentIndex

      public int getComponentIndex(Component component)
      Maps JPopupMenu.getComponentIndex(Component) through queue
    • getInvoker

      public Component getInvoker()
      Maps JPopupMenu.getInvoker() through queue
    • getLabel

      public String getLabel()
      Maps JPopupMenu.getLabel() through queue
    • getMargin

      public Insets getMargin()
      Maps JPopupMenu.getMargin() through queue
    • getSelectionModel

      public SingleSelectionModel getSelectionModel()
      Maps JPopupMenu.getSelectionModel() through queue
    • getSubElements

      public MenuElement[] getSubElements()
      Maps JPopupMenu.getSubElements() through queue
    • getUI

      public PopupMenuUI getUI()
      Maps JPopupMenu.getUI() through queue
    • insert

      public void insert(Component component, int i)
      Maps JPopupMenu.insert(Component, int) through queue
    • insert

      public void insert(Action action, int i)
      Maps JPopupMenu.insert(Action, int) through queue
    • isBorderPainted

      public boolean isBorderPainted()
      Maps JPopupMenu.isBorderPainted() through queue
    • isLightWeightPopupEnabled

      public boolean isLightWeightPopupEnabled()
      Maps JPopupMenu.isLightWeightPopupEnabled() through queue
    • pack

      public void pack()
      Maps JPopupMenu.pack() through queue
    • processKeyEvent

      public void processKeyEvent(KeyEvent keyEvent, MenuElement[] menuElement, MenuSelectionManager menuSelectionManager)
      Maps JPopupMenu.processKeyEvent(KeyEvent, MenuElement[], MenuSelectionManager) through queue
    • processMouseEvent

      public void processMouseEvent(MouseEvent mouseEvent, MenuElement[] menuElement, MenuSelectionManager menuSelectionManager)
      Maps JPopupMenu.processMouseEvent(MouseEvent, MenuElement[], MenuSelectionManager) through queue
    • removePopupMenuListener

      public void removePopupMenuListener(PopupMenuListener popupMenuListener)
      Maps JPopupMenu.removePopupMenuListener(PopupMenuListener) through queue
    • setBorderPainted

      public void setBorderPainted(boolean b)
      Maps JPopupMenu.setBorderPainted(boolean) through queue
    • setInvoker

      public void setInvoker(Component component)
      Maps JPopupMenu.setInvoker(Component) through queue
    • setLabel

      public void setLabel(String string)
      Maps JPopupMenu.setLabel(String) through queue
    • setLightWeightPopupEnabled

      public void setLightWeightPopupEnabled(boolean b)
      Maps JPopupMenu.setLightWeightPopupEnabled(boolean) through queue
    • setPopupSize

      public void setPopupSize(int i, int i1)
      Maps JPopupMenu.setPopupSize(int, int) through queue
    • setPopupSize

      public void setPopupSize(Dimension dimension)
      Maps JPopupMenu.setPopupSize(Dimension) through queue
    • setSelected

      public void setSelected(Component component)
      Maps JPopupMenu.setSelected(Component) through queue
    • setSelectionModel

      public void setSelectionModel(SingleSelectionModel singleSelectionModel)
      Maps JPopupMenu.setSelectionModel(SingleSelectionModel) through queue
    • setUI

      public void setUI(PopupMenuUI popupMenuUI)
      Maps JPopupMenu.setUI(PopupMenuUI) through queue
    • show

      public void show(Component component, int i, int i1)
      Maps JPopupMenu.show(Component, int, int) through queue