Deassign Drop a Verb Group

This Subprogram may be used to deassign (drop) a previously assigned Verb Group ID. All Verbs and Menus associated with the Group will automatically also be dropped. This request will be treated as illegal if the specified Group is Locked.

Short Name Calling Sequence

STATUS = UIDRGP(GROUP)

Long Name Calling Sequence

STATUS = UI_DROP_GROUP(...)

Input Arguments

GROUP (Integer) Group ID

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_GROUP ) Illegal Group ID UIILGP )

UI__LOCKED_GROUP ) Group Locked UIGLOK ) Note:

1. Group 0 is preserved always. Thus, although all Verbs and Menus associated with Group 0 may be dropped by a call to this Subprogram, Group 0 itself will be retained and cannot therefore be assigned or defined by subsequent calls to UI_ASSIGN_GROUP or UI_DEFINE_GROUP.
2. Error UI__LOCKED_GROUP will be returned if the specified Group has been locked by a prior call to UI_LOCK_GROUP.