This function returns the enabled state (1 or 0) of the menu item specified by menupath. If the parameter active is supplied, the menu item is enabled or disabled based on the value of active and the function returns the previous state of the menu item.

The function returns -1 if menupath does not specify an existing menu item.