Difference between revisions of "DIALOG FIELDS"

From Recital Documentation Wiki
Jump to: navigation, search
Line 1: Line 1:
=DIALOG FIELDS=
 
 
 
 
==Class==
 
==Class==
 
Screen Dialogs
 
Screen Dialogs
Line 11: Line 8:
  
 
==Syntax==
 
==Syntax==
DIALOG FIELDS
+
DIALOG FIELDS [LABEL <expC>]
 
+
[LABEL <expC>]
+
  
  
 
==See Also==
 
==See Also==
[[DIALOG FILES]], [[DIALOG GET]], [[DIALOG MESSAGE]], [[DIALOG QUERY]], [[DIALOG SCOPE]], [[MENU FIELDS]], [[MENUITEM()]], [[SET COLOR]], [[SET COLOR OF]]
+
[[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==
 
==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 DESCRIPTION is ON.
+
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 SET COLOR and SET COLOR OF DIALOGFRAME commands may be used to specify the colors for the dialog box and frame.

Revision as of 11:40, 28 April 2009

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