Dialogs

Navigation:  Client commands > Tools > Client command editor > Command list >

Dialogs

Version 1.0.0

Show hidden text

hmtoggle_arrow1Dialogs

This command serves to create a dialog, which is displayed to the user and with which input can be made. As a caption, a short heading must be entered  that is displayed in the header of the dialog. Furthermore, a message can be entered, which is then displayed as a text field in the actual dialog.

 

5.8.3.2.7 - Dialogs 1

 

Under Message type, a symbol to be displayed can be selected, which may be your own image or even no image at all. In the same way, the buttons to be displayed can be specified. They are enabled by checkmarking the relevant box, and the associated text can be freely selected in the text field. If the commnad is to be cancelled when a certain button is clicked, the corresponding box under Fail Buttons must be checkmarked. Of course, the whole matter only makes sense if the corresponding buttons are also displayed.

 

The result of the Dialog actions is saved in the variable specified in the section Store results to. For more informateion about variables, see chapter Variables.

 

You can access the data as follows:

%VarName.InputValue%

%VarName.ClickedButton%        

%VarName.MyCheckboxCaption%

- Any entered value

- The clicked button (OK, Cancel, Yes, No, or timeout)

- Returns a Boolean value (True, False) to question whether a caption was entered

 

Hinweis

Note:

VarName refers to the variable entered by you and must be changed accordingly.

 

5.8.3.2.7 - Dialogs 2

 

In the Input settings tab, you can configure the settings for data input. The data input feature is activated by checkmarking the box at Dialog requires input. If the box at Password protected is checkmarked as well, the input field turns into a password field (* instead of letters/numbers). In Prompt you can specify the type of data that are to be entered, and in Default, you can enter a default value.

 

As input, you can select various templates, e.g. a simple input field for manual input. Furthermore, there is the option to display a drop-down list, a list of radio buttons and a list of checkboxes. For radio buttons, it is only possible to select one value, while for checkboxes multiple selection is possible. In this case, several values are entered in the bottom text field with one field per line. If the checkbox Deny manual input is activated, users are able to enter their own data.

 

In the Advanced settings tab, users can specify that the dialog must be closed after a cetain time  - measured in seconds -, while the variable %VarName.ClickedButton% can be set to a specific value (default: Timeout).

 

hmtoggle_arrow1Open file dialog

With this command you can open an Open file dialog. In this way, users can select dynamic data that are then transferred to the Client Command.

 

5.8.3.2.7 - OpenFileDialog

 

In the Details tab, you can enter a caption for the dialog. With the default directory, you can enter a path, in which the dialog is already preselected. With the default file name   you can preselect a file name.

 

With the filters, you can formulate various file filters. To this end, enter a file name on the left hand, and the filter on the right hand in the table. The filter must be specified in the familiar format (e.g., *.*). More filters can be added with the green plus button and delete with the red minus button.

 

The path and the name of the file to be selected are stored in the variable to be specified. You can create a new project variable with the right-hand button.

 

In the Options tab, you will find many customization options. These options are self-explanatory and will therefore not be explained in more detail.

 

hmtoggle_arrow1Save file dialog

With this command you can open an Store file dialog. It is now possible to save data in a file from the Client Command.

 

Enter a caption for the dialog in the Details tab. With the default directory, you can enter a path, in which the dialog is already preselected. With the default file name   you can preselect a file name.

 

With the filters, you can formulate various file filters. To this end, enter a file name on the left hand, and the filter on the right hand in the table. The filter must be specified in the familiar format (e.g., *.*). More filters can be added with the green plus button and delete with the red minus button.

 

5.8.3.2.7 - SaveFileDialog

 

The path and the name of the file to be selected are stored in the variable to be specified. You can create a new project variable with the right-hand button.

 

In the Options tab, you will find many customization options. These options are self-explanatory and will therefore not be explained in more detail.

 

hmtoggle_arrow1Browse for folder

With this command you can open a Browse for folder dialog. In this way, users can assign a directory to the Client Command, which can use the Client Command for further operations.

 

5.8.3.2.7 - BrowseFolder

 

Enter a directory, which will be the home directory of the dialog, in the Details tab. The title is the caption of the dialog.

 

The path is stored in the variable to be specified. You can create a new project variable with the right-hand button.

 

In the Options tab, you will find some customization options. These options are self-explanatory and will therefore not be explained in more detail.

 

hmtoggle_arrow1Set progressform properties

With this command you can display a progress bar. To do this, enter a caption and any two other data. Alternatively, you can also enter variables (see Variables) to always display the current variable value with a checkmark, e.g. the current file name when copying files.

 

In this field an image to be displayed can be entered, in which case there is a choice of a default image, no image, the last used image and an image from a file. For Load from image file, the option Transparent can be selected as well, in which case the image can be selected via the input field.

 

5.8.3.2.7 - SetProgressForm

 

In the Progress bar field, you can select a value between 0 and 100. In this connection a variable is also very helpful to always show a current value.

 

hmtoggle_arrow1Show progressform

This command shows displays a progress bar for the benefit of users. The necessary settings can be entered via the Set progressform properties command. This command does not require special settings.

 

hmtoggle_arrow1Hide progressform

This command hides a progress bar displayed for the benefit of the user. This command does not require special settings.

 

hmtoggle_arrow1Form editor

With this command you can create your own dialog and have it displayed. If you click on the Form edit button in the new dialog, an IDE environment opens.

 

5.8.3.2.7 - FormEditor

 

Here you can create and edit the dialog according to your needs. Since this command requires DelphiScript skills, you should only use this command if you have such skills. If you have such skills, you will be easily able to find your way in this environment; therefore, no further explanations are required at this stage.

 

For more information about this command, see chapter Form editor.

Last change on 10.03.2014