View source for ACTIVATE MENU

=ACTIVATE MENU=


==Class==
Menus


==Purpose==
Activate an Xbase style bar menu


==Syntax==
ACTIVATE MENU <expC1>

[NOCLEAR]

[NOWAIT]

[PAD <expC2>]


==See Also==
[[DEACTIVATE MENU]], [[DEFINE MENU]], [[DEFINE PAD]], [[ON PAD]], [[PAD()]], [[SET COMPATIBLE]], [[SHOW MENU]]


==Description==
The ACTIVATE MENU command activates and displays an Xbase style menu.  The menu name <expC1> must have been previously defined.  The command SET COMPATIBLE must be set ON when using Xbase style menus.

====NOCLEAR====
The NOCLEAR keyword prevents the popup display being cleared after the menu is exited.

====NOWAIT====
The NOWAIT clause will not wait for user input after the ACTIVATE POPUP command is issued.  The popup is displayed and activated, but program execution continues immediately.

====PAD <expC2>====
The optional PAD keyword will position the highlight bar on the pad name <expC2> when the menu is displayed.  The pad name must have been previously defined.  If no pad name is used, then the highlight is positioned on the first defined pad.


==Example==
<code lang="recital">
activate menu sort_men
</code>


==Products==
Recital Mirage Server, Recital Terminal Developer
[[Category:Documentation]]
[[Category:Commands]]