sm_menu_remove - Library Functions (Programming Guide)

Programming Guide

sm_menu_remove

Removes a menu from display
int sm_menu_remove(int scope);
scope
Specifies which menu to remove from display:

MNS_APPLIC
Removes the application menu.
MNS_SCREEN
Removes the current screen's menu, either installed with the current screen or inherited from another screen.
MNS_FIELD
Removes the current field's menu.

Returns

0 MNERR_OK: Success.

-2 MNERROR_EMPTY_SCOPE: Menu not installed at specified scope.

-3 MNERR_NOT_SUPPORTED: Invalid scope or menus not supported.

Description

sm_menu_remove makes a menu unavailable for display at the specified scope. Because the script remains loaded, any subsequent changes to the menu's properties become visible when you reinstall it.
This function has no effect on other instances of the menu that are installed from the same memory location.

See Also

sm_menu_install