Displays on the screen a dialog box that is the specified color scheme and contains the specified body text and button text.
Syntax
int _Dialog(int scheme, char FAR *body_text, char FAR *button1,
char FAR *button2, char FAR *button3, int default, int escape)
int scheme; /* Color scheme number. */
char FAR *body_text; /* Text in dialog. */
char FAR *button1; /* Button prompt. */
char FAR *button2; /* Button prompt. */
char FAR *button3; /* Button prompt. */
int default; /* Number of the default button. */
int escape; /* Number of the button to press if Esc. */
Remarks
_Dialog( ) returns the number of the button the user chooses.
To specify fewer than three buttons for the displayed dialog box, specify 0 as a button prompt to leave any of the three buttons blank. The default parameter specifies which button to highlight in the dialog box as the default button, and the escape parameter specifies which button to process as chosen if the user presses ESC.
If you specify no buttons, Visual FoxPro displays the dialog box and waits for the user to press a key or click the left mouse button. If the user presses Esc, _Dialog( ) returns the escape value; otherwise, it returns the default value.
For more information on how to create an API library and integrate it with Visual FoxPro, see Chapter 28, Accessing the Visual FoxPro API, in the Programmer's Guide.