 |
Dial_InputDialog |
Displays an input dialog box, in which the user can fill the input fields. Each of the up to 20 input fields can be a normal text input field, a password field, a popup menu or a checkbox.
Syntax
Dial_InputDialog (switches ; nr. of fields ; prompt ; button1 ; button2 ;
button3 ; button4 )
Parameters
| switches | this determines the behavior of the dialog and which information is returned |
| nr. of fields | the number of input fields to be shown. This can be 1 to 20 |
| prompt | the text of the dialog |
| button1..4 | the text of the 1st to the 4th button (from right to left) |
Switches
If you specify an empty button text, no button will be displayed. Switches can be empty or you can add one or more of these switches:
| -ReturnButtonText | return the *text* of the button, instead of the number |
You can also add one of these switches:
| -DefaultButton1…-Defaultbutton4 | indicates which button will be selected when the user presses the ENTER key |
For each field you can also add one of these field format switches:
| -Bullet1…-Bullet20 | this indicates for a field that it is a bullet field |
| -Popup1…-Popup20 | this indicates for a field that it is a popup field |
| -Checkbox1…-Checkbox20 | this indicates for a field that it is a checkbox field |
If you don’t specify a field format switch the field will be a normal text input field.
You can also add this switch:
| -KeepBulletText | this will fill bullet fields with initial text (shown as bullets), if set with the Dial_SetInput function |
You can also add one of these switches:
| -StopIcon | shows a stop icon (indicating this is something severe which the user needs to address ) |
| -CautionIcon | shows a caution icon (indicating this dialog warns the user) |
| -NoteIcon | shows a note icon (indicating this dialog gives the user information) |
| -CustomIcon | shows a custom icon. This icon needs to be set before with the Dial_IconControl function. |
You can also add this switch:
| -IconSize=48 | display the icon at 48×48 pixels |
You can also add this switch:
| -StopOnESC | if you add this switch the user can press the ESC key to leave the dialog. The dialog returns as button number 0. |
You can also add one or more of these switches:
| -StartField1…-StartField20 | specifies the input field the cursor will be in at the start of the dialog |
| -AlignLabelsRight | this will align the text of the labels to the right (close to the input field) |
| -LabelTextColorGray | sets the text color of the labels of the dialog to gray |
| -MonospacedFont | the input and popup fields will be shown in a monospaced (fixed-pitch) font |
Returned Result
Data type returned
Text
Result
The number of the button that was clicked followed by the text of the input fields. By adding switches this function can also return the text of the button.
Originated in
Troi Dialog Plug-in 2.0
Compatibility
FileMaker Pro 16 to 19
Considerations
Starting with version 9.0 you can have up to 20 input fields (was 15).
See “Dial_SetDialogTitle” if you want to change the title of the dialog.
See “Dial_SetPosition” if you want to change the position of the dialog.
See “Dial_SetInput” to set the text to be preentered into the input fields.
See “Dial_SetLabels” to set the labels to the left of the input fields.
See “Dial_SetPopup” to set the popup values to be used for popup fields.
Note: you can display popup values from a second value list. The selected value from the first popup value list is returned. You can use this for example with a list of ItemIDs and a list of ItemDescriptions. The descriptions are shown to the user, while the itemID is returned.
New switches added with v9.0: -AlignLabelsRight and -LabelTextColorGray.
Version 11.0 added the switch “-MonospacedFont”.
You can also use the keyboard shortcuts: copy (command-C), paste (command-V), cut (command-X) and select all (command-A) in the text fields.
Example
Set Field [ result ; Dial_InputDialog ( "-NoteIcon" ; 5 ;
"Please enter your personal data:" ;
"OK" ; "Cancel" ; "Help" ; "Stop" ) ]This will show 5 input fields to fill in, with a note icon. If the user clicked the OK button a possible result can be: “1|John|Smith|Berkeley|USA|student”.
Example 2
We assume that in your FileMaker file the following fields are defined:
result Global, text
gErrorCode Global, textAdd the following script steps:
Set Field [ gErrorCode ; Dial_SetLabels ( "-Unused " ; "Name" ; "Password" ;
"Remember password" ; ) ]
Set Field [ gErrorCode ; Dial_SetInput ( "-Unused" ; Get ( UserName ) ; "" ; "1" ; ) ]
Set Field [ result ; Dial_InputDialog ( "-StopIcon -Bullet2 -Checkbox3" ; 3 ;
"Please enter your name and password:" ;
"OK" ; "Cancel" ; "Help" ; "Stop" ) ]This will show a user/password dialog which also has a checkbox callled “Remember password”. The checkbox will be checked because the input for that field is set to 1.
Used in example file
Input.fmp12
Related functions
| Dial_GetButton |
| Dial_SetDialogTitle |
| Dial_SetInput |
| Dial_SetLabels |
| Dial_SetPopup |
| Dial_SetPosition |
Related topics
Troi Dialog Plug-in online help (overview)
