next up previous contents
Next: Deassign Drop a Up: Retained Menu Definition Previous: Retained Menu Definition

Assign Menu ID

This Subprogram may be used to assign or allocate a free Menu ID. This assignment will be unique within a particular program such that programmers each coding a program module to be later blended together may ensure that they avoid clashes with conflicting Menus etc.

Short Name Calling Sequence

STATUS = UIASME(MENUID)

Long Name Calling Sequence

STATUS = UI_ASSIGN_MENU(...)

Input Arguments

None

Output Arguments

MENUID (Integer) Menu ID

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__NO_FREE_MENUS ) No Free Menus available UINOME )

Note:

  1. Menu IDs lie in the range 0-4095.


Liz Buckle
Fri Jan 13 17:39:04 CST 1995