Displays a modal dialog used by a parameterized view for input of a single string.
INPUTBOX(cInputPrompt [, cDialogCaption [, cDefaultValue [, nTimeout [,cTimeoutValue] [,cCancelValue]]]]) |
Parameters
- cInputPrompt
- Specifies the Prompt displayed above the text entry box.
- cDialogCaption
- Specifies the text to display in the title bar of the dialog box.
- cDefaultValue
- Specifies a default value to display in the text entry box.
- nTimeout
- Specifies a timeout value in 1/1000 seconds. Specify zero in nTimeout to prevent the dialog from timing out. This is identical to omitting nTimeout.
- cTimeoutValue
- Specifies value to return if a timeout occurs. cTimeoutValue isn't returned if nTimeout is set to zero or is omitted.
- cCancelValue
- Specifies a character value to return if the user exits the dialog box by choosing the Cancel button or pressing the Esc key.
Remarks
The dialog box displays an edit box and OK and Cancel buttons. The OK button returns the contents of the edit box. A timeout returns the text specified in cTimeoutValue or an empty string if cTimeoutValue is unspecified. The Cancel button or the Esc key returns the text specified in cCancelValue or an empty string if cCancelValue is unspecified.
Example 1
Code
В | Copy Code |
---|---|
Y = "Nothing at all" Y = INPUTBOX("TypeHere","Input ",Y,5000) && Displays dialog box for 5 seconds, |
Example 2
The following example displays a dialog box for five seconds and displays the return value in the main Visual FoxPro window. If the user clicks OK, the edit box returns the text which is either the default value, "Nothing at all," or user-specified text. If the user clicks Cancel or hits the ESC key, the edit box returns "Canceled." If the user waits the timeout period, the edit box closes and returns "Timed Out."
Code
В | Copy Code |
---|---|
CLEAR Y = INPUTBOX("Type Here:", "Input Title", ; "Nothing at all", 5000, 'Timed Out', 'Canceled') ? Y |