ACTIVATE POPUP

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Activate an XBase style pop-up menu


Syntax

ACTIVATE POPUP <expC>

[AT <expN1>,<expN2>]

[BAR <expN3>]

[NOCLEAR]

[NOWAIT]


See Also

BAR(), DEACTIVATE POPUP, DEFINE POPUP, POPUP(), PROMPT(), SHOW POPUP, SET COMPATIBLE


Description

The ACTIVATE POPUP command activates an Xbase style pop-up menu name <expC> and displays it when the user moves the highlight to the corresponding pad. Each pop-up is DEACTIVATED as the highlight is moved to the next pad, or when the DEACTIVATE POPUP command is used.

AT <expN1>,<expN2>

You can specify where the popup is displayed by including AT <expN1>,<expN2>. The upper left corner of the popup is positioned at the coordinates specified by <expN1>,<expN2>. The position specified by this clause take precedence over a position specified by the FROM clause in DEFINE POPUP.

BAR <expN>

The BAR <expN3> allows you to specify the selected popup option number when the popup is displayed.

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.


Example

on pad file_nm of sort_men activate popup popup_1
on pad srt_type of sort_men activate popup popup_2
on pad key_nm of sort_men activate popup popup_3
on pad prfrm of sort_men activate popup popup_4


Products

Recital