DIALOG FIELDS

Class

Screen Dialogs

Purpose

Display a dialog for selecting fields from a table

Syntax

DIALOG FIELDS [LABEL <expC>]

See Also

DIALOG FILES, DIALOG GET, DIALOG MESSAGE, DIALOG QUERY, DIALOG SCOPE, Function Keys, MENU FIELDS, MENUITEM(), SET COLOR, SET COLOR OF, SET DESCRIPTIONS, SET DIALOG

Description

This dialog displays a menu of field names of fields from the current table. Field descriptions rather than field names are displayed if SET DESCRIPTIONS is ON.

The SET COLOR and SET COLOR OF DIALOGFRAME commands may be used to specify the colors for the dialog box and frame.

The cursor and [PAGE UP], [PAGE DOWN] keys are used to navigate the menu, the [RETURN] key to select a filename. Once a filename is selected, the 'OK' and 'Cancel' buttons or the [EXIT SAVE] and [ABANDON] keys can be used to exit the dialog with or without saving.

On exit from DIALOG FIELDS, the MENUITEM() function can be used to return the selected field name as a character string. If the user pressed the 'Cancel' button or the [ABANDON] key, MENUITEM() will return a null string.

LABEL <expC>

The LABEL clause is used to change the default dialog title to the text specified in <expC>.

Example

use demo
dialog fields
? menuitem()

Products

Recital Terminal Developer