Deassign Drop a Menu

This Subprogram may be used to deassign (drop) a previously assigned Menu ID. If the Menu has some buttons associated with it, then these will also be dropped. This request will be treated as illegal if the Group associated with the specified Menu is Locked.

Short Name Calling Sequence

STATUS = UIDRME(MENUID)

Long Name Calling Sequence

STATUS = UI_DROP_MENU(...)

Input Arguments

MENUID (Integer) Menu ID

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package Not Initialized UININI )

UI__ILLEGAL_MENU ) Illegal Menu ID UIILME )

UI__ILLEGAL_GROUP ) Illegal Group ID UIILGP )

UI__LOCKED_GROUP ) Group Locked UIGLOK )

Note:

1. Error UI__LOCKED_GROUP will be returned if the Verb Group corresponding to the specified Menu ID has been locked by a prior call to UI_LOCK_GROUP.