View source for Squish/Verifying the Existence of a Menu Item

To verify the existence of a menu item within a menu, there are multiple approaches: 1) accessing the QAction list supplied to us by the QWidget class through the Qt API or 2) using Squish's real name to see if the object exists.

In the end, the usage of any of these approaches are as simple as:
<code>
test.verify(menuItemExists("File", "&Save"))
</code>

== Qt API approach ==

This approach uses the Qt API to access the menu and the menu's actions, and then iterate through all of the actions to see if it contains the one we are looking for.

<code>
def menuItemExists(menu, menuItem):
  menuName = '{title="%s" type="QMenu" window=":Window"}' % menu
  waitFor("object.exists(menuName)", 20000)
  actions = findObject(menuName).actions()
  for i in range(actions.size()):
    action = actions.at(i)
    if action.text == menuItem:
      return True
  return False
</code>

We start out by using the real name of the menu to identify it, as that gives us the ability to dynamically specify which menu Squish should be looking for. We then wait for it to exist, to make sure the script is not played back to fast, retrieve the QAction list from the menu and iterate through them, comparing the text property of QAction with the text we supply in the argument.

== Squish's real name approach ==

Similar to the approach above where we use the real name to get to the menu, we do the same thing but with the menu item instead.

<code>
def menuItemExists(menu, menuItem):
  menuName = '{title="%s" type="QMenu" window=":Window"}' % menu
  menuItemName = '{container=%s text="%s" type="QAction"}' % (menuName, menuItem)
  return object.exists(menuItemName)
</code>