The finditem() function returns the numeric position of a specific item in a menu or list field. List fields include list boxes, multi-select list boxes, combo boxes, drop-down lists, button drop lists and visual switches. If the specified item doesn’t appear in the menu or field, a 0 is returned.


finditem([field|menu] name, expression)


name – The name of the menu or list field for which you want to return the position of an item. The field must be a window field.

expression – A string specifying the item you want to find.

Return value



Grouped menu items that the application inherited, such as the Clipboard menu items Cut, Copy and Paste, are not counted when the location of an item in a menu is returned.

Documentation Feedback