de_prompt()

Invokes the prompt dialog box in the current window with user-supplied prompt string and sets a call back AEL function (aelFuncName) to be called when the OK button is selected. Dialog box has a single text field in which to type a response to the prompt string. Returns: none.

Syntax:

de_prompt(title, promptLabel, defaultAnswer, okCB, aelFuncName);

where

title is a dialog box title.

promptLabel is a string; label.

defaultAnswer is the initial text displayed in the text field. This string can be set to NULL.

okCB is the OK callback which will override the default OK callback. NULL if not used. This callback function should take three arguments. For example, my_prompt_ok_cb (okH, dlgH, winInst), where:

• okH is the handle to the OK button
• dlgH is the handle to the prompt dialog
• winInst is the current window instance

aelFuncName is a string. AEL function to call when OK is pressed. This function takes 1 string argument which is the response text in the text field. The response text is passed to the AEL function when OK is pressed.

Example:

defun my_prompt_cb(input_str)
 {
   fputs(stderr, input_str);
 }
 de_prompt("my prompt", "please enter answer", "yes", NULL, "my_prompt_cb");

Where Used:

Graphical user interface