org.safs.model.components

Class PopupMenu

java.lang.Object

org.safs.model.Component

org.safs.model.components.UIComponent

org.safs.model.components.GenericMaster

org.safs.model.components.GenericObject

org.safs.model.components.PopupMenu

public class PopupMenu
extends GenericObject

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PopupMenu(java.lang.String compname)
	PopupMenu(java.lang.String winname, java.lang.String compname) Constructor Create an instance of pseudo-component representing a specific component in a specific window.
	PopupMenu(Window window, java.lang.String compname) Constructor Create an instance of pseudo-component representing a specific component in a specific window.

Method Summary

Modifier and Type	Method and Description
void	selectPopupMenuID(StepTestTable table, java.lang.String menuItemID) Select a menuItem via its menuID in the currently active popup menu.
ComponentFunction	selectPopupMenuID(java.lang.String menuItemID) Select a menuItem via its menuID in the currently active popup menu.
void	selectPopupMenuItem(StepTestTable table, java.lang.String menuItemText) Select a menuItem via its text in the currently active popup menu.
ComponentFunction	selectPopupMenuItem(java.lang.String menuItemText) Select a menuItem via its text in the currently active popup menu.
void	selectUnverifiedPopupMenuItem(StepTestTable table, java.lang.String menuItemText) Select a menuItem via its text in the currently active popup menu without verification.
ComponentFunction	selectUnverifiedPopupMenuItem(java.lang.String menuItemText) Select a menuItem via its text in the currently active popup menu without verification.
void	verifyPopupMenu(StepTestTable table, java.lang.String[] parameters) Verify the complete status of the current popup menu with a benchmark file.
void	verifyPopupMenu(StepTestTable table, java.lang.String benchmarkFile, java.lang.String headerText, java.lang.String actualFile, java.lang.String diffFile) Verify the complete status of the current popup menu with a benchmark file.
ComponentFunction	verifyPopupMenu(java.lang.String[] parameters) Verify the complete status of the current popup menu with a benchmark file.
ComponentFunction	verifyPopupMenu(java.lang.String benchmarkFile, java.lang.String headerText, java.lang.String actualFile, java.lang.String diffFile) Verify the complete status of the current popup menu with a benchmark file.
void	verifyPopupMenuID(StepTestTable table, java.lang.String[] parameters) Verify the state of a menuItem via its menuID in the currently active popup menu.
void	verifyPopupMenuID(StepTestTable table, java.lang.String menuItemID, java.lang.String stateInfo) Verify the state of a menuItem via its menuID in the currently active popup menu.
ComponentFunction	verifyPopupMenuID(java.lang.String[] parameters) Verify the state of a menuItem via its menuID in the currently active popup menu.
ComponentFunction	verifyPopupMenuID(java.lang.String menuItemID, java.lang.String stateInfo) Verify the state of a menuItem via its menuID in the currently active popup menu.
void	verifyPopupMenuItem(StepTestTable table, java.lang.String[] parameters) Verify the state of a menuItem found via its text in the currently active popup menu.
void	verifyPopupMenuItem(StepTestTable table, java.lang.String menuItemText, java.lang.String stateInfo) Verify the state of a menuItem found via its text in the currently active popup menu.
ComponentFunction	verifyPopupMenuItem(java.lang.String[] parameters) Verify the state of a menuItem found via its text in the currently active popup menu.
ComponentFunction	verifyPopupMenuItem(java.lang.String menuItemText, java.lang.String stateInfo) Verify the state of a menuItem found via its text in the currently active popup menu.
void	verifyPopupMenuPartialMatch(StepTestTable table, java.lang.String menuItemText) Verify if a menuItem contains a substring Verify if a menuItem contains a substring For Java popups: Valid recognition information for the Java window and "child" popup menu must be provided.
ComponentFunction	verifyPopupMenuPartialMatch(java.lang.String menuItemText) Verify if a menuItem contains a substring Verify if a menuItem contains a substring For Java popups: Valid recognition information for the Java window and "child" popup menu must be provided.

Methods inherited from class org.safs.model.components.GenericObject

altLeftDrag, altLeftDrag, click, click, click, click, clickScreenImage, clickScreenImage, clickScreenLocation, clickScreenLocation, clickScreenPoint, clickScreenPoint, compareStoredData, compareStoredData, compareStoredData, compareStoredData, compareStoredProperties, compareStoredProperties, compareStoredProperties, compareStoredProperties, ctrlAltLeftDrag, ctrlAltLeftDrag, ctrlClick, ctrlClick, ctrlClick, ctrlClick, ctrlClickScreenImage, ctrlClickScreenImage, ctrlLeftDrag, ctrlLeftDrag, ctrlRightClick, ctrlRightClick, ctrlRightClick, ctrlRightClick, ctrlRightClickScreenImage, ctrlRightClickScreenImage, ctrlShiftLeftDrag, ctrlShiftLeftDrag, doubleClick, doubleClick, doubleClick, doubleClick, doubleClickScreenImage, doubleClickScreenImage, doubleClickScreenLocation, doubleClickScreenLocation, doubleClickScreenPoint, doubleClickScreenPoint, doubleTap, doubleTap, dragTo, dragTo, dragTo, dragTo, flick, flick, flick, flick, flickDown, flickDown, flickLeft, flickLeft, flickRight, flickRight, flickUp, flickUp, hScrollTo, hScrollTo, javaMenuSelect, javaMenuSelect, leftDrag, leftDrag, mouseClick, mouseClick, multiClick, multiClick, multiClick, multiClick, multiClickScreenImage, multiClickScreenImage, multiClickScreenImage, multiClickScreenImage, press, press, rightClick, rightClick, rightClick, rightClick, rightClickScreenImage, rightClickScreenImage, rightClickScreenLocation, rightClickScreenLocation, rightClickScreenPoint, rightClickScreenPoint, rightDrag, rightDrag, shiftClick, shiftClick, shiftClick, shiftClick, shiftClickScreenImage, shiftClickScreenImage, shiftLeftDrag, shiftLeftDrag, tap, tap, twoFingerTap, twoFingerTap, verifyImage, verifyImage, vScrollTo, vScrollTo

Methods inherited from class org.safs.model.components.GenericMaster

assignPropertyVariable, assignPropertyVariable, assignPropertyVariable, assignPropertyVariable, captureObjectDataToFile, captureObjectDataToFile, captureObjectDataToFile, captureObjectDataToFile, capturePropertiesToFile, capturePropertiesToFile, capturePropertiesToFile, capturePropertiesToFile, capturePropertyToFile, capturePropertyToFile, capturePropertyToFile, capturePropertyToFile, clearAppMapCache, clearAppMapCache, clearCache, clearCache, executeScript, executeScript, executeScript, executeScript, getComputedStyle, getComputedStyle, getGUIImage, getGUIImage, getGUIImage, getGUIImage, getTextFromGUI, getTextFromGUI, getTextFromGUI, getTextFromGUI, gUIDoesExist, gUIDoesExist, gUIDoesNotExist, gUIDoesNotExist, hoverMouse, hoverMouse, hoverMouse, hoverMouse, hoverScreenLocation, hoverScreenLocation, hoverScreenLocation, hoverScreenLocation, inputCharacters, inputCharacters, inputKeys, inputKeys, isPropertyExist, isPropertyExist, isPropertyExist, isPropertyExist, locateScreenImage, locateScreenImage, locateScreenImage, locateScreenImage, saveTextFromGUI, saveTextFromGUI, saveTextFromGUI, saveTextFromGUI, sendEvent, sendEvent, sendEvent, sendEvent, setPropertyValue, setPropertyValue, setPropertyValue, setPropertyValue, showOnPage, showOnPage, typeChars, typeChars, typeEncryption, typeEncryption, typeEncryption, typeEncryption, typeKeys, typeKeys, verifyArrayPropertyToFile, verifyArrayPropertyToFile, verifyArrayPropertyToFile, verifyArrayPropertyToFile, verifyBinaryFileToFile, verifyBinaryFileToFile, verifyBinaryFileToFile, verifyBinaryFileToFile, verifyClipboardToFile, verifyClipboardToFile, verifyClipboardToFile, verifyClipboardToFile, verifyClipboardVP, verifyClipboardVP, verifyComputedStyle, verifyComputedStyle, verifyFileToFile, verifyFileToFile, verifyFileToFile, verifyFileToFile, verifyGUIImageToFile, verifyGUIImageToFile, verifyGUIImageToFile, verifyGUIImageToFile, verifyObjectDataToFile, verifyObjectDataToFile, verifyObjectDataToFile, verifyObjectDataToFile, verifyPropertiesSubsetToFile, verifyPropertiesSubsetToFile, verifyPropertiesSubsetToFile, verifyPropertiesSubsetToFile, verifyPropertiesToFile, verifyPropertiesToFile, verifyPropertiesToFile, verifyPropertiesToFile, verifyProperty, verifyProperty, verifyProperty, verifyProperty, verifyPropertyContains, verifyPropertyContains, verifyPropertyContains, verifyPropertyContains, verifyPropertyToFile, verifyPropertyToFile, verifyPropertyToFile, verifyPropertyToFile, verifyTabOrder, verifyTabOrder, verifyTextFileToFile, verifyTextFileToFile, verifyTextFileToFile, verifyTextFileToFile, verifyValueContains, verifyValueContains, verifyValueContains, verifyValueContains, verifyValueContainsIgnoreCase, verifyValueContainsIgnoreCase, verifyValueContainsIgnoreCase, verifyValueContainsIgnoreCase, verifyValueDoesNotContain, verifyValueDoesNotContain, verifyValueDoesNotContain, verifyValueDoesNotContain, verifyValues, verifyValues, verifyValues, verifyValues, verifyValuesIgnoreCase, verifyValuesIgnoreCase, verifyValuesIgnoreCase, verifyValuesIgnoreCase, verifyValuesNotEqual, verifyValuesNotEqual, verifyValuesNotEqual, verifyValuesNotEqual

Methods inherited from class org.safs.model.components.UIComponent

getWindow, setWindow

Methods inherited from class org.safs.model.Component

getName, getParent, getParentName, quote

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PopupMenu

public PopupMenu(Window window,
                 java.lang.String compname)

Constructor Create an instance of pseudo-component representing a specific component in a specific window.

Parameters:

window - Optional:NO Specifies which Window this component is 'in'.

compname - Optional:NO Specifies the AppMap name of the component in the Window.

PopupMenu

public PopupMenu(java.lang.String winname,
                 java.lang.String compname)

Constructor Create an instance of pseudo-component representing a specific component in a specific window. This convenience routine will create the requisite Window component.

Parameters:

winname - Optional:NO Specifies the AppMap name of the window.

compname - Optional:NO Specifies the AppMap name of the component in the Window.

PopupMenu

protected PopupMenu(java.lang.String compname)

Method Detail

selectPopupMenuID

public ComponentFunction selectPopupMenuID(java.lang.String menuItemID)

 
                Select a menuItem via its menuID in the currently active popup menu.
               
                Attempts to select a particular menuID in the currently 
                active popup menu.  This is generally used when the menuitem is a bitmap 
                or other item that does not have text.  This value can be retrieved from 
                the the menu by index or by manual lookup from a menu structure output 
                from MenuUtilities.
                
                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.
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                  

Supporting Engines:

• Rational Robot

Parameters:

menuItemID - Optional:NO The Windows menuID of the menuItem to select.

selectPopupMenuID

public void selectPopupMenuID(StepTestTable table,
                              java.lang.String menuItemID)

 
                Select a menuItem via its menuID in the currently active popup menu.
               
                Attempts to select a particular menuID in the currently 
                active popup menu.  This is generally used when the menuitem is a bitmap 
                or other item that does not have text.  This value can be retrieved from 
                the the menu by index or by manual lookup from a menu structure output 
                from MenuUtilities.
                
                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.
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                  

Supporting Engines:

• Rational Robot

Parameters:

table - Optional:NO The table to add the record to.

menuItemID - Optional:NO The Windows menuID of the menuItem to select.

selectPopupMenuItem

public ComponentFunction selectPopupMenuItem(java.lang.String menuItemText)

 
                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.                 
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ
• AutomatedQA TestComplete

Parameters:

menuItemText - Optional:NO Menu->MenuItem hierarchy to the menuItem to select.

selectPopupMenuItem

public void selectPopupMenuItem(StepTestTable table,
                                java.lang.String menuItemText)

 
                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.                 
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ
• AutomatedQA TestComplete

Parameters:

table - Optional:NO The table to add the record to.

menuItemText - Optional:NO Menu->MenuItem hierarchy to the menuItem to select.

selectUnverifiedPopupMenuItem

public ComponentFunction selectUnverifiedPopupMenuItem(java.lang.String menuItemText)

 
                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.
                
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                
                TC Note:Component can be the object who contains 'popup menu', or it
                can be the 'context menu' object. 
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ
• AutomatedQA TestComplete

Parameters:

menuItemText - Optional:NO Menu->MenuItem hierarchy to the menuItem to select.

selectUnverifiedPopupMenuItem

public void selectUnverifiedPopupMenuItem(StepTestTable table,
                                          java.lang.String menuItemText)

 
                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.
                
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                
                TC Note:Component can be the object who contains 'popup menu', or it
                can be the 'context menu' object. 
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ
• AutomatedQA TestComplete

Parameters:

table - Optional:NO The table to add the record to.

menuItemText - Optional:NO Menu->MenuItem hierarchy to the menuItem to select.

verifyPopupMenu

public ComponentFunction verifyPopupMenu(java.lang.String benchmarkFile,
                                         java.lang.String headerText,
                                         java.lang.String actualFile,
                                         java.lang.String diffFile)

 
                Verify the complete status of the current popup menu with a benchmark file.
              
                Verify the complete status of the current popup menu with a benchmark file.
                Typically, benchmarks are stored in the Datapool\Bench directory.  
                In that event, only the filename.ext is needed.  There is currently 
                a limit of 32K allowed for this type of comparison.  
                The Window and Component objects are not validated and have no role.
                The Window and Component strings can be any text, but they cannot be blank.
                
                Due to the nature of the verification using a DOS file comparison, the popup 
                menu will no longer be present after the verification and must be reactivated 
                if additional popup menu activity is to occur.
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

benchmarkFile - Optional:NO The name.ext of the file used as the comparison benchmark.

headerText - Optional:YES DefaultVal: Optional descriptive header line of text to match with the benchmark.

actualFile - Optional:YES DefaultVal: The optional name.ext of the file used for the captured menu status.

diffFile - Optional:YES DefaultVal: The optional name.ext of the file used to contain the differences found.

verifyPopupMenu

public void verifyPopupMenu(StepTestTable table,
                            java.lang.String benchmarkFile,
                            java.lang.String headerText,
                            java.lang.String actualFile,
                            java.lang.String diffFile)

 
                Verify the complete status of the current popup menu with a benchmark file.
              
                Verify the complete status of the current popup menu with a benchmark file.
                Typically, benchmarks are stored in the Datapool\Bench directory.  
                In that event, only the filename.ext is needed.  There is currently 
                a limit of 32K allowed for this type of comparison.  
                The Window and Component objects are not validated and have no role.
                The Window and Component strings can be any text, but they cannot be blank.
                
                Due to the nature of the verification using a DOS file comparison, the popup 
                menu will no longer be present after the verification and must be reactivated 
                if additional popup menu activity is to occur.
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

table - Optional:NO The table to add the record to.

benchmarkFile - Optional:NO The name.ext of the file used as the comparison benchmark.

headerText - Optional:YES DefaultVal: Optional descriptive header line of text to match with the benchmark.

actualFile - Optional:YES DefaultVal: The optional name.ext of the file used for the captured menu status.

diffFile - Optional:YES DefaultVal: The optional name.ext of the file used to contain the differences found.

verifyPopupMenu

public ComponentFunction verifyPopupMenu(java.lang.String[] parameters)

 
                Verify the complete status of the current popup menu with a benchmark file.
              
                Verify the complete status of the current popup menu with a benchmark file.
                Typically, benchmarks are stored in the Datapool\Bench directory.  
                In that event, only the filename.ext is needed.  There is currently 
                a limit of 32K allowed for this type of comparison.  
                The Window and Component objects are not validated and have no role.
                The Window and Component strings can be any text, but they cannot be blank.
                
                Due to the nature of the verification using a DOS file comparison, the popup 
                menu will no longer be present after the verification and must be reactivated 
                if additional popup menu activity is to occur.
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

parameters - Optional:NO An array containing the following parameters:

benchmarkFile -- Optional:NO The name.ext of the file used as the comparison benchmark.
headerText -- Optional:YES DefaultVal: Optional descriptive header line of text to match with the benchmark.
actualFile -- Optional:YES DefaultVal: The optional name.ext of the file used for the captured menu status.
diffFile -- Optional:YES DefaultVal: The optional name.ext of the file used to contain the differences found.

verifyPopupMenu

public void verifyPopupMenu(StepTestTable table,
                            java.lang.String[] parameters)

 
                Verify the complete status of the current popup menu with a benchmark file.
              
                Verify the complete status of the current popup menu with a benchmark file.
                Typically, benchmarks are stored in the Datapool\Bench directory.  
                In that event, only the filename.ext is needed.  There is currently 
                a limit of 32K allowed for this type of comparison.  
                The Window and Component objects are not validated and have no role.
                The Window and Component strings can be any text, but they cannot be blank.
                
                Due to the nature of the verification using a DOS file comparison, the popup 
                menu will no longer be present after the verification and must be reactivated 
                if additional popup menu activity is to occur.
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

table - Optional:NO The table to add the record to.

parameters - Optional:NO An array containing the following parameters:

benchmarkFile -- Optional:NO The name.ext of the file used as the comparison benchmark.
headerText -- Optional:YES DefaultVal: Optional descriptive header line of text to match with the benchmark.
actualFile -- Optional:YES DefaultVal: The optional name.ext of the file used for the captured menu status.
diffFile -- Optional:YES DefaultVal: The optional name.ext of the file used to contain the differences found.

verifyPopupMenuID

public ComponentFunction verifyPopupMenuID(java.lang.String menuItemID,
                                           java.lang.String stateInfo)

 
                Verify the state of a menuItem via its menuID in the currently active popup menu.
               
                Verify the state of a particular menuID in the currently 
                active popup menu.  This is generally used when the menuitem is a bitmap 
                or other item that does not have text.  This menuID can be retrieved from 
                the the menu by index or by manual lookup from a menu structure output 
                from MenuUtilities.
                
                The routine first verifies that the specified menuitem exists
                and exits with error if it does not.
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                  

Supporting Engines:

• Rational Robot

Parameters:

menuItemID - Optional:NO The Windows menuID of the menuItem to verify.

stateInfo - Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuID

public void verifyPopupMenuID(StepTestTable table,
                              java.lang.String menuItemID,
                              java.lang.String stateInfo)

 
                Verify the state of a menuItem via its menuID in the currently active popup menu.
               
                Verify the state of a particular menuID in the currently 
                active popup menu.  This is generally used when the menuitem is a bitmap 
                or other item that does not have text.  This menuID can be retrieved from 
                the the menu by index or by manual lookup from a menu structure output 
                from MenuUtilities.
                
                The routine first verifies that the specified menuitem exists
                and exits with error if it does not.
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                  

Supporting Engines:

• Rational Robot

Parameters:

table - Optional:NO The table to add the record to.

menuItemID - Optional:NO The Windows menuID of the menuItem to verify.

stateInfo - Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuID

public ComponentFunction verifyPopupMenuID(java.lang.String[] parameters)

 
                Verify the state of a menuItem via its menuID in the currently active popup menu.
               
                Verify the state of a particular menuID in the currently 
                active popup menu.  This is generally used when the menuitem is a bitmap 
                or other item that does not have text.  This menuID can be retrieved from 
                the the menu by index or by manual lookup from a menu structure output 
                from MenuUtilities.
                
                The routine first verifies that the specified menuitem exists
                and exits with error if it does not.
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                  

Supporting Engines:

• Rational Robot

Parameters:

parameters - Optional:NO An array containing the following parameters:

menuItemID -- Optional:NO The Windows menuID of the menuItem to verify.
stateInfo -- Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuID

public void verifyPopupMenuID(StepTestTable table,
                              java.lang.String[] parameters)

 
                Verify the state of a menuItem via its menuID in the currently active popup menu.
               
                Verify the state of a particular menuID in the currently 
                active popup menu.  This is generally used when the menuitem is a bitmap 
                or other item that does not have text.  This menuID can be retrieved from 
                the the menu by index or by manual lookup from a menu structure output 
                from MenuUtilities.
                
                The routine first verifies that the specified menuitem exists
                and exits with error if it does not.
                
                For RC and Win32 popups: The Window and Component references are not 
                used and can be anything.  They just cannot be blank.
                  

Supporting Engines:

• Rational Robot

Parameters:

table - Optional:NO The table to add the record to.

parameters - Optional:NO An array containing the following parameters:

menuItemID -- Optional:NO The Windows menuID of the menuItem to verify.
stateInfo -- Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuItem

public ComponentFunction verifyPopupMenuItem(java.lang.String menuItemText,
                                             java.lang.String stateInfo)

 
                Verify the state of a menuItem found via its text 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.
                
                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.                
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

menuItemText - Optional:NO Menu->MenuItem hierarchy to the menuItem to verify.

stateInfo - Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuItem

public void verifyPopupMenuItem(StepTestTable table,
                                java.lang.String menuItemText,
                                java.lang.String stateInfo)

 
                Verify the state of a menuItem found via its text 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.
                
                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.                
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

table - Optional:NO The table to add the record to.

menuItemText - Optional:NO Menu->MenuItem hierarchy to the menuItem to verify.

stateInfo - Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuItem

public ComponentFunction verifyPopupMenuItem(java.lang.String[] parameters)

 
                Verify the state of a menuItem found via its text 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.
                
                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.                
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

parameters - Optional:NO An array containing the following parameters:

menuItemText -- Optional:NO Menu->MenuItem hierarchy to the menuItem to verify.
stateInfo -- Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuItem

public void verifyPopupMenuItem(StepTestTable table,
                                java.lang.String[] parameters)

 
                Verify the state of a menuItem found via its text 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.
                
                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.                
                  

Supporting Engines:

• Rational Robot
• Rational RobotJ

Parameters:

table - Optional:NO The table to add the record to.

parameters - Optional:NO An array containing the following parameters:

menuItemText -- Optional:NO Menu->MenuItem hierarchy to the menuItem to verify.
stateInfo -- Optional:NO Expected status string (or part thereof) to verify.

verifyPopupMenuPartialMatch

public ComponentFunction verifyPopupMenuPartialMatch(java.lang.String menuItemText)

 
                Verify if a menuItem contains a substring
               
                Verify if a menuItem contains a substring
                
                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.                
                  

Supporting Engines:

• Rational RobotJ

Parameters:

menuItemText - Optional:NO Menu->MenuItem hierarchy substring to the menuItem to search for.

verifyPopupMenuPartialMatch

public void verifyPopupMenuPartialMatch(StepTestTable table,
                                        java.lang.String menuItemText)

 
                Verify if a menuItem contains a substring
               
                Verify if a menuItem contains a substring
                
                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.                
                  

Supporting Engines:

• Rational RobotJ

Parameters:

table - Optional:NO The table to add the record to.

menuItemText - Optional:NO Menu->MenuItem hierarchy substring to the menuItem to search for.