From Clomosy Docs

No edit summary
No edit summary
Line 1: Line 1:
function InputQuery(const Caption, Prompt string; var UserValue string):Boolean;
<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>


'''Example:'''<br>
<b>Example</b><br>
:'''Base Syntax'''
<b>TRObject Syntax</b><br>
var
<pre>
  valueName : string;
var
valueName : string;
  begin
{
  repeat
  repeat
    if not InputQuery('Project', 'Please type your name', valueName)
  if not InputQuery('Project', 'Please type your name', valueName)
     then ShowMessage('User cancelled the dialog');  
     ShowMessage('User cancelled the dialog');  
  until valueName <> <nowiki>''</nowiki>;
until valueName <> '';
   
 
  ShowMessage('Hello '+valueName);
ShowMessage('Hello '+valueName);
  end;
}
</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 <> '';


'''Output:'''<br>
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

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;

Output:
InputQueryExample.png

See Also