MENU SCOPE

From Recital Documentation Wiki
Revision as of 16:03, 3 September 2010 by Yvonnemilne (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Purpose

Display a popup menu for choosing record selection scope


Syntax

MENU SCOPE

[AT<expN1>,<expN2>]

[HELPFILE <.hlp filename> | (<expC1>)]

[LABEL <expC2>]

[OFF]

[POPUP]


See Also

@...MENU, MENU AT, MENU COMMAND, MENU FIELDS, MENU FILES, MENU FORMAT, MENU QUERY, SCOPE


Description

The MENU SCOPE command displays a menu containing possible record selection scopes.


Scope Description
Default scope of the operation, e.g. FOR is all, WHILE is rest.
Next Process next n records. Enter number of records to process, starting from current record.
All Process all records.
Record Process selected record. Enter the record number of the record to process.
Rest Process all remaining records, starting from current record.
First Process first n records. Enter number of records to process, starting from top of file.


AT <expN1>,<expN2>

Position top left hand corner of menu at these row, column coordinates.


Keyword Description
HELPFILE <.hlp> A helpful text file can be associated with the menu. The <.hlp filename> will be displayed in a read-only window for viewing when the [HELP] key is pressed. The window will be labeled "Operating instructions." The file name can be substituted with a <expC2>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, then ".hlp" is assumed. The command, INSTRUCT, must be set ON when using this option.
LABEL <expC2> The specified character string <expC2> is displayed at the top of the menu frame.
OFF The display of messages in the message line is disabled.
POPUP The screen is automatically saved when the menu is displayed, and restored when the menu is cleared.


The following keys are active in the MENU SCOPE:


Key Action
[CURSOR UP] Skip to previous menu item
[CURSOR DOWN] Skip to next menu item
[RETURN] Select a menu item
[ABANDON] Abandon selection
[EXIT/SAVE] Exit without selecting a scope


You can select a menu item by entering its first character.

On exit from MENU SCOPE the MENUITEM() function will return the record selection scope. If the [ABANDON] key was pressed, or no scope was selected, then MENUITEM() will return an empty string "" and MENU() will return –1.


Example

menu scope at 2,0
store menuitem() to scope
report form patrons &scope to print


Products

Recital