THE Reference - Commands

DIALOG - display a user configurable dialog box
Syntax:: DIALOG /prompt/ [EDITfield [/val/]] [TITLE /title/] [OK|OKCANCEL|YESNO|YESNOCANCEL] [DEFBUTTON n]
Description:: The DIALOG command displays a dialog box in the middle of the screen with user-configurable settings.; The mandatory prompt parameter, is the text of a prompt displayed near the top of the dialog window. Up to 10 lines can be displayed by separating lines with a character (decimal 10).; EDITfield creates a user enterable field, with a default value of val , if supplied. While the cursor is in the editfield, "normal" edit keys are in effect. See READV for more details on keys that are useable in the editfield. The same keys that exit from the READV command also exit the editfield. On exit from the editfield, the first button becomes active.; title specifies optional text to be displayed on the border of the dialog box.; The type of button combination can be specifed as one of the following:; OK - just an OK button is displayed; OKCANCEL - an OK and a CANCEL button are displayed; YESNO - a YES and a NO button are displayed; YESNOCANCEL - a YES, a NO and a CANCEL button are displayed; If no button combination is selected, an OK button is displayed.; If DEFBUTTON is specified, it indicates which of the buttons is to be set as the active button. This is a number between 1 and the number of buttons displayed. By default, button 1 is active. If EDITfield is specified, no active button is set.; The active button can be selected by pressing the TAB key; to exit from the DIALOG, press the RETURN or ENTER key, or click the first mouse button on the required button.; On exit from the DIALOG command, the following Rexx variables are set:; DIALOG.0 - 2; DIALOG.1 - value of 'EDITfield'; DIALOG.2 - button selected as specified in the call to the command.; The colours used for the dialog box are:; Border - SET COLOR DIVIDER; Prompt area - SET COLOR DIALOG; Editfield - SET COLOR CMDLINE; Inactive button - SET COLOR BLOCK; Active button - SET COLOR CBLOCK
Compatibility:: XEDIT: N/A; KEDIT: Compatible. Does not support bitmap icons or font options.
See Also:: POPUP, ALERT, READV, SET COLOR
Status:: Complete.

Return to Table of Contents