Simulating Menu Actions

A window or control may be associated with menus of different types: top-level windows may have the main, system and context menus; child windows and controls may have a context menu.

To simulate user actions over a menu:

1. TestLeft UI Spy does not show menus in the object hierarchy. To access menus, use the appropriate properties of parent objects.

   Get the window or control over whose menu you want to simulate actions:

   • In TestLeft UI Spy, if needed, click and configure the code generation settings. For example, select the language you use to create tests.

   • Drag the Pick Object’s target glyph to the needed window or control and release the mouse button.

     — or —

     Click Point and Fix on the UI Spy toolbar and move the mouse pointer to the needed window or control. When a red frame appears around the window or control, press the Shift+Ctrl+Z shortcut.

   • TestLeft UI Spy will highlight the selected window or control in the object hierarchy.

   • Right-click the object and then click Copy Identification.

   • Add the generated identification code to your test.

2. TestLeft always can access the main and system menus, however, to enable it to access a context menu, you need to invoke the context menu on screen first. To invoke a context menu, you can add methods that simulate a right-click in the appropriate window or control or send the Application key press to it.

3. Access the menu of the window or control:

   • .NET
   • Java

   • To access the system menu, use the SystemMenu property provided by the ITopLevelWindow interface.

   • To access the main and context menus created with standard Windows components, use the MainMenu property provided by the ITopLevelWindow interface and the PopupMenu property provided by the IWindow interface.

   • To access menus created with third-party components, use the StripMainMenu, ActionMainMenu, XtraMainMenu and other properties provided by the appropriate interfaces.

   • To access the system menu, use the getSystemMenu() method provided by the TopLevelWindow class.

   • To access the main and context menus created with standard Windows components, use the getMainMenu() method provided by the TopLevelWindow class and the getPopupMenu() method provided by the Window class.

   • To access menus created with third-party components, use the getStripMainMenu(), getActionMainMenu(), getXtraMainMenu() and other methods provided by the appropriate classes.

4. • .NET
   • Java

   Use the IMenu interface to work with the menu. The interface provides methods and properties that let you perform various operations:

   Method or Property	Description
   Click	Simulates a click on a menu item.
   Check	Simulates checking or unchecking a menu item.
   Select	Simulates placing the mouse pointer over a menu item.
   Items	Provides access to individual menu items.
   Count	Returns the number of items in a menu.

   Use the Menu class to work with the menu. The class provides methods and properties that let you perform various operations:

   Method or Property	Description
   click	Simulates a click on a menu item.
   check	Simulates checking or unchecking a menu item.
   select	Simulates placing the mouse pointer over a menu item.
   getItems	Returns an individual menu item.
   getCount	Returns the number of items in a menu.

Example

Using Native Menu Actions

Capturing Images for Simulated Menu Actions

See Also

Simulating User Actions
Creating TestLeft Tests
About Driver Objects
Object Identification