From Clomosy Docs
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
<div class="alert alert-ligth border border-3 border-primary-subtle rounded-5 p-4 shadow-sm" role="alert"> | |||
function InputQuery(const Caption, Prompt: string; var UserValue: string):Boolean; | |||
</div> | |||
The InputQuery function displays a simple dialog with the Caption and Prompt message provided. Prompts the user to enter data in a text box in the dialog. If the user presses OK, the entered data is stored in the UserValue variable and the return value is True. If the user cancels the dialog, the return value is False and all entered data is lost.<br> | The InputQuery function displays a simple dialog with the Caption and Prompt message provided. Prompts the user to enter data in a text box in the dialog. If the user presses OK, the entered data is stored in the UserValue variable and the return value is True. If the user cancels the dialog, the return value is False and all entered data is lost.<br> | ||
| Line 5: | Line 7: | ||
Use to prompt the user for simple data such as name.<br> | Use to prompt the user for simple data such as name.<br> | ||
<b>Example</b><br> | |||
<b>TRObject Syntax</b><br> | |||
<pre> | |||
var | |||
valueName : string; | |||
{ | |||
repeat | |||
if not InputQuery('Project', 'Please type your name', valueName) | |||
ShowMessage('User cancelled the dialog'); | |||
until valueName <> ''; | |||
ShowMessage('Hello '+valueName); | |||
} | |||
</pre> | |||
<b>Base Syntax</b><br> | |||
<pre> | |||
var | |||
valueName : string; | |||
begin | |||
repeat | |||
if not InputQuery('Project', 'Please type your name', valueName) | |||
then ShowMessage('User cancelled the dialog'); | |||
until valueName <> ''; | |||
'' | ShowMessage('Hello '+valueName); | ||
end; | |||
</pre> | |||
<b>Output:</b><br> | |||
[[File:InputQueryExample.png|frameless|400px]] | [[File:InputQueryExample.png|frameless|400px]] | ||
<h2> See Also </h2> | |||
* [[System_Library#Input-Output_Functions | Input Output Functions]] | |||
Revision as of 13:45, 7 October 2024
function InputQuery(const Caption, Prompt: string; var UserValue: string):Boolean;
The InputQuery function displays a simple dialog with the Caption and Prompt message provided. Prompts the user to enter data in a text box in the dialog. If the user presses OK, the entered data is stored in the UserValue variable and the return value is True. If the user cancels the dialog, the return value is False and all entered data is lost.
Use to prompt the user for simple data such as name.
Example
TRObject Syntax
var
valueName : string;
{
repeat
if not InputQuery('Project', 'Please type your name', valueName)
ShowMessage('User cancelled the dialog');
until valueName <> '';
ShowMessage('Hello '+valueName);
}
Base Syntax
var
valueName : string;
begin
repeat
if not InputQuery('Project', 'Please type your name', valueName)
then ShowMessage('User cancelled the dialog');
until valueName <> '';
ShowMessage('Hello '+valueName);
end;
