check tree node menu state

Check the state of a specified menu item on a context menu of a tree node against an expected value.
NameDescriptionTypeModifier
window

TA name of the window.

Interface EntityNone
tree

TA name of the tree control.

Interface ElementNone
node path

Path to the node (see ).

StringNone
menu item

Menu item or menu item path (see ).

StringNone
expected

Expected value(s) of the menu item.

Possible values:

  • disabled: The menu item is unavailable or disabled.
  • enabled: The menu item is enabled or available.
  • checked: The menu item is selected.

Tip: 
Use commas (,) as delimiters between expected values of the state property.

Value Setdisabled, enabled, checked
x

(Optional) Horizontal position of effective click on tree node, specified as distance in pixels from left edge of tree node.

Default Value: horizontal center of tree node.
StringNone
y

(Optional) Vertical position of effective click on tree node , specified as distance in pixels from top edge of tree node.

Default Value: vertical center of tree node.
StringNone
Result is Passed if the values match, otherwise Failed.
This action may be used within the following project items: test modules and user-defined actions.
This action is applicable to the following controls: tree view, tree table, tree list.
Example - Case 1: Using a text value for node path

        
        	window	tree	node path	menu item	expected	x	y
check tree node menu state	sample	tree view	Item.0/Item.3	Item.3->Item.3.1	enabled		
        
    
Example - Case 2: Using a numerical index for node path

        
        	window	tree	node path	menu item	expected	x	y
check tree node menu state	sample	tree view	1/3	Item.3->Item.3.1	enabled		
        
    
  • node path argument:
    • The node path may be specified by its display textor by a numerical index representing its cardinal placement in its branch, with index values starting at 1.
    • If a node path of more than one item must be specified, use forward slashes ( / ) as delimiters between node levels.
  • menu item argument:
    • Menu items are identified by their caption properties.
    • If a menu path of more than one item must be specified, use arrow symbols ( -> ) as delimiters between menu items. For example, Vehicles->Cars->Four-door sedans.
  • Enclose a numerical text string in quotation marks to differentiate it from a numerical index value. For example, if a text value of an item in a control has a value of 12, you should reference that item by passing 12 surrounded by quotation marks (that is, "12") instead of the numerical 12. Passing the numerical 12 is treated as a reference to an item with an index of 12, rather than an item holding a text string value of 12.
  • This action supports the <ignore> modifier. If the string <ignore> is present as the value of any of the arguments, or any argument contains an expression that evaluates to <ignore>, the action is skipped during execution.

Copyright © 2023 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1(800) 322-0333