ReNamer:Pascal Script:Dialogs

From den4b Wiki
Jump to: navigation, search

Interactive dialogs or How to let user decide

Sometimes we need to ask the user for data or inform him about something. In that case we need an interactive dialog.

Informative dialogs

The simplest one is WideShowMessage(const Msg: String) procedure that takes a string and displays it as a small popup window with OK button.

WideShowMessage('That''s a message for you!');

If you know that the string will contain only ANSI characters you may use ShowMessage(const Msg: WideString) procedure instead.

Asking user for data

There are several dialogs to ask user for data:

function DialogYesNo(const Msg: String): Boolean;
function InputBox(const ACaption, APrompt: String; var Value: String): Boolean;
function InputQuery(const ACaption, APrompt: String; var Value: String): Boolean;
function WideInputBox(const ACaption, APrompt: String; var Value: String): Boolean;
function WideInputQuery(const ACaption, APrompt: String; var Value: String): Boolean;

Let's take a look on some of them.

DialogYesNo function takes a message string and lets user to choose between YES and NO buttons to click. It returns True if YES was choosen and False otherwise.

  if DialogYesNo('This filename "'+FileName+'" looks bad.'+#13+
    'I would prefer to name that file "Very Important File.txt". '+#13#13+'Do you agree?') then
  FileName := 'Very Important File.txt';

The code above shows two important things about string constants. First is that you need to use #13 (or #10 or #13#10) to break the line. And second that you need to escape every ' by doubling it (''). So if you want to start a string constant with ' you will need three of them ''' !

WideInputQuery is the most powerful dialog. It takes two string constants (a caption of the popup window and a prompt, in which you can explain what kind of data you are expecting from the user). The third parameter is a WideString variable Value that will return user text input back to you. The current content of the Value variable is displayed in the input text box as the default value. Apart from that the InputQuery function will return True if OK button was pressed and False otherwise.

  Value: WideString;
  Value := 'Meaningless filename.txt';
  if WideInputQuery('Incorrect filename',
    'I am not able to produce any meaningful filename!'+
    ' Would you mind giving it manually?', Value) then  FileName := Value;