Class JMenuOperator

All Implemented Interfaces:
Outputable, Timeoutable

public class JMenuOperator extends JMenuItemOperator implements Outputable, Timeoutable


Timeouts used:
JMenuOperator.WaitBeforePopupTimeout - time to sleep before popup expanding
JMenuOperator.WaitPopupTimeout - time to wait popup displayed
JMenuOperator.PushMenuTimeout - time for the whole menu operation
JMenuItemOperator.PushMenuTimeout - 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:
  • Field Details

  • Constructor Details

    • JMenuOperator

      public JMenuOperator(JMenu menu)
      Constructor.
      Parameters:
      menu - a component
    • JMenuOperator

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

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

      public JMenuOperator(ContainerOperator cont, String text, int index)
      Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.
      Parameters:
      cont - a container
      text - Button text.
      index - Ordinal component index.
      Throws:
      TimeoutExpiredException
      See Also:
    • JMenuOperator

      public JMenuOperator(ContainerOperator cont, String text)
      Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.
      Parameters:
      cont - a container
      text - Button text.
      Throws:
      TimeoutExpiredException
      See Also:
    • JMenuOperator

      public JMenuOperator(ContainerOperator cont, int index)
      Constructor. Waits component in container first. Uses cont's timeout and output for waiting and to init operator.
      Parameters:
      cont - a container
      index - Ordinal component index.
      Throws:
      TimeoutExpiredException
    • JMenuOperator

      public JMenuOperator(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
  • Method Details

    • findJMenu

      public static JMenu findJMenu(Container cont, ComponentChooser chooser, int index)
      Searches JMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - org.netbeans.jemmy.ComponentChooser implementation.
      index - Ordinal component index.
      Returns:
      JMenu instance or null if component was not found.
    • findJMenu

      public static JMenu findJMenu(Container cont, ComponentChooser chooser)
      Searches 0'th JMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - org.netbeans.jemmy.ComponentChooser implementation.
      Returns:
      JMenu instance or null if component was not found.
    • findJMenu

      public static JMenu findJMenu(Container cont, String text, boolean ce, boolean ccs, int index)
      Searches JMenu 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:
      JMenu instance or null if component was not found.
      See Also:
    • findJMenu

      public static JMenu findJMenu(Container cont, String text, boolean ce, boolean ccs)
      Searches JMenu 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:
      JMenu instance or null if component was not found.
      See Also:
    • waitJMenu

      public static JMenu waitJMenu(Container cont, ComponentChooser chooser, int index)
      Waits JMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - org.netbeans.jemmy.ComponentChooser implementation.
      index - Ordinal component index.
      Returns:
      JMenu instance.
      Throws:
      TimeoutExpiredException
    • waitJMenu

      public static JMenu waitJMenu(Container cont, ComponentChooser chooser)
      Waits 0'th JMenu in container.
      Parameters:
      cont - Container to search component in.
      chooser - org.netbeans.jemmy.ComponentChooser implementation.
      Returns:
      JMenu instance.
      Throws:
      TimeoutExpiredException
    • waitJMenu

      public static JMenu waitJMenu(Container cont, String text, boolean ce, boolean ccs, int index)
      Waits JMenu 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:
      JMenu instance.
      Throws:
      TimeoutExpiredException
      See Also:
    • waitJMenu

      public static JMenu waitJMenu(Container cont, String text, boolean ce, boolean ccs)
      Waits JMenu 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:
      JMenu instance.
      Throws:
      TimeoutExpiredException
      See Also:
    • performInit

      public static void performInit()
    • setTimeouts

      public void setTimeouts(Timeouts timeouts)
      Description copied from interface: Timeoutable
      Defines current timeouts.
      Specified by:
      setTimeouts in interface Timeoutable
      Overrides:
      setTimeouts in class JMenuItemOperator
      Parameters:
      timeouts - 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 JMenuItemOperator
      Returns:
      the collection of current timeout assignments.
      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 JMenuItemOperator
      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 JMenuItemOperator
      Returns:
      an object that contains references to objects for printing to output and err streams.
      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 AbstractButtonOperator
      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. Uses StringComparator assigned to this object,
      Parameters:
      names - Menu items texts.
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
    • 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 pushMenuNoBlock(String) or pushMenuNoBlock(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. Uses StringComparator assigned to this object,
      Parameters:
      path - String menupath representation ("File/New", for example).
      delim - String menupath divider ("/").
      Returns:
      Last pushed JMenuItem.
      Throws:
      TimeoutExpiredException
      See Also:
    • 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, 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, 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)
      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, 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, 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)
      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: AbstractButtonOperator
      Returns information about component.
      Overrides:
      getDump in class JMenuItemOperator
      Returns:
      a Hashtable containing name-value pairs.
    • add

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

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

      public JMenuItem add(JMenuItem jMenuItem)
      Maps JMenu.add(JMenuItem) through queue
    • addMenuListener

      public void addMenuListener(MenuListener menuListener)
      Maps JMenu.addMenuListener(MenuListener) through queue
    • addSeparator

      public void addSeparator()
      Maps JMenu.addSeparator() through queue
    • getDelay

      public int getDelay()
      Maps JMenu.getDelay() through queue
    • getItem

      public JMenuItem getItem(int i)
      Maps JMenu.getItem(int) through queue
    • getItemCount

      public int getItemCount()
      Maps JMenu.getItemCount() through queue
    • getMenuComponent

      public Component getMenuComponent(int i)
      Maps JMenu.getMenuComponent(int) through queue
    • getMenuComponentCount

      public int getMenuComponentCount()
      Maps JMenu.getMenuComponentCount() through queue
    • getMenuComponents

      public Component[] getMenuComponents()
      Maps JMenu.getMenuComponents() through queue
    • getPopupMenu

      public JPopupMenu getPopupMenu()
      Maps JMenu.getPopupMenu() through queue
    • insert

      public void insert(String string, int i)
      Maps JMenu.insert(String, int) through queue
    • insert

      public JMenuItem insert(Action action, int i)
      Maps JMenu.insert(Action, int) through queue
    • insert

      public JMenuItem insert(JMenuItem jMenuItem, int i)
      Maps JMenu.insert(JMenuItem, int) through queue
    • insertSeparator

      public void insertSeparator(int i)
      Maps JMenu.insertSeparator(int) through queue
    • isMenuComponent

      public boolean isMenuComponent(Component component)
      Maps JMenu.isMenuComponent(Component) through queue
    • isPopupMenuVisible

      public boolean isPopupMenuVisible()
      Maps JMenu.isPopupMenuVisible() through queue
    • isTearOff

      public boolean isTearOff()
      Maps JMenu.isTearOff() through queue
    • isTopLevelMenu

      public boolean isTopLevelMenu()
      Maps JMenu.isTopLevelMenu() through queue
    • remove

      public void remove(JMenuItem jMenuItem)
      Maps JMenu.remove(JMenuItem) through queue
    • removeMenuListener

      public void removeMenuListener(MenuListener menuListener)
      Maps JMenu.removeMenuListener(MenuListener) through queue
    • setDelay

      public void setDelay(int i)
      Maps JMenu.setDelay(int) through queue
    • setMenuLocation

      public void setMenuLocation(int i, int i1)
      Maps JMenu.setMenuLocation(int, int) through queue
    • setPopupMenuVisible

      public void setPopupMenuVisible(boolean b)
      Maps JMenu.setPopupMenuVisible(boolean) through queue