TestComplete PopupMenuFunctions

Last Updated:

Actions for ACTIVE Popup Menus

Actions for ACTIVE Popup Menus.
The popup menu must usually already be up and active for each of these Actions.

It is important to recognize certain issues with Popup menus, especially as we need to differentiate between Java popups and Win32 popups.

Win32 popup menus are generally found as the topmost active popup window. Because of this, we generally can just look for the topmost active popup window and we don't need any type of recognition information to locate it.

Java popup menus are generally NOT implemented as normal Win32 popup menus and we generally DO need to have window and component recognition information for Java popup menus.

For RC and Win32 popups: Unless otherwise indicated, the Window and Component references are not used and can be anything. They just cannot be blank.

For Java popups: Unless otherwise indicated, valid recognition information for the Java window and "child" popup menu must be provided.

Also refer to JavaMenuFunctions for support specific to Java menus and popup menus.

TestComplete PopupMenuFunctions::SelectPopupMenuItem
TC:NETJAV

Select a menuItem via its text in the currently active popup menu.

Attempts to select a particular text string menuitem in the currently active popup menu. The menuitem should be specified in the form "Menu->Menu->MenuItem CTRL+V" with the full text, spaces(if any), and keyboard shortcut text (if any).

Ampersands preceding underlined characters are optional. The routine first verifies that the specified menuitem exists and exits with error if it does not. If it does exist then the selection proceeds using the MenuID retrieved from the found menuitem.

For RC and Win32 popups: The Window and Component references are not used and can be anything. They just cannot be blank.

For Java popups: Valid recognition information for the Java window and "child" popup menu must be provided.

Also refer to JavaMenuFunctions for support specific to Java menus and popup menus.

TC Note:Component can be the object who contains 'popup menu', or it can be the 'context menu' object.

Fields: [ ]=Optional with Default Value

MenuItemText

Menu->MenuItem hierarchy to the menuItem to select.

Menu->MenuItem hierarchy string to identify which menuitem to select.
NOTE:SQA can only handle submenus up to 5 levels deep.
NOTE:For RJ implementation, this field is optional if the "child" is a "MenuItem"

Examples:

T, Anything, AtAll, SelectPopupMenuItem, "File->Save Ctrl+S"
Select the File/Save menuItem from the currently active popup menu.

Select the File/Save menuItem from the currently active popup menu.
The full text must include any spaces and visible shortcut key combos that are displayed in the text of the menuItem.

T, Anything, AtAll, SelectPopupMenuItem, "&File->&Save Ctrl+S"
Select the File/Save menuItem from the currently active popup menu.

Select the File/Save menuItem from the currently active popup menu.
The full text must include any spaces and visible shortcut key combos that are displayed in the text of the menuItem.
Ampersands (&) indicating/preceding underlined characters are optional.

T, ParentWindow, popupMenu, SelectPopupMenuItem, "File->Save"
RJ Usage: If File/Save menuItem exists in the currently active popup menu, then select it.

T, ParentWindow, popupFileMenu, SelectPopupMenuItem, "Save"
RJ Usage: If File/Save menuItem exists in the currently active popup menu, then select it.

T, ParentWindow, popupSaveMenu, SelectPopupMenuItem
RJ Usage: If File/Save menuItem exists in the currently active popup menu, then select it.

[How To Read This Reference]

TestComplete PopupMenuFunctions::SelectUnverifiedPopupMenuItem
TC:NET

Select a menuItem via its text in the currently active popup menu without verification.

Attempts to select a particular text string menuitem in the currently active popup menu. This routine performs no verification prior to or following the selection. This may cause a Rational error if the Popup Menu or selected menu item is not available.

The menuitem should be specified in the form "Menu->Menu->MenuItem CTRL+V" with the full text, spaces(if any), and keyboard shortcut text (if any).

Ampersands preceding underlined characters are optional.