 |
Dial_SetInput |
Sets the text to be pre-entered in the input fields of the next input dialog.
Syntax
Dial_SetInput ( switches ; text1 ; text2 ; text3 ; text4 ; ... ; text20 )
Parameters
| switches | not used, reserved for future use. Leave blank or put "-Unused" |
| text1…text20 | the text that will be pre-entered into the input fields 1 to 20 |
Returned Result
Data type returned
Error code
Result
An error code. Currently the plug-in always returns 0.
Originated in
Troi Dialog Plug-in 3.0
Compatibility
FileMaker Pro 16 to 19
Considerations
The text of the input field(s) is saved by the plug-in until a dialog is displayed. Please be aware that each dialog function of the plug-in resets the text. Dialogs that have no input field(s) will set the text to “”. (This is to be able to extend the functionality of these functions in the future).
When the FileMaker application stops, the input data is reset to “”.
For password fields: the text is ignored (as you can’t see it anyway).
For popup fields: if the text is present in the list of possible choices the first one is selected.
For checkbox fields: use 1 and 0 to check resp. uncheck a checkbox field.
Example
Set Field [ gErrorCode ;
Dial_SetInput ( "-Unused" ; "Apple" ; "London" ; "16" ; "Brown" ; "Square" ; ) ]This will set the text to be used as the pre-entered text in the next InputDialog function to the five texts.
Example 2
This example will set the pre-entered text to your user name and the value from a field. We assume that in your FileMaker file the following fields are defined:
gErrorCode Global, text
gFieldText Global, textAdd the following script step:
Set Field [ result ; Dial_SetInput ( "-Unused" ; Get ( UserName ) ; gFieldText ; ) ]Used in example file
Input.fmp12
Related functions
| Dial_GetButton |
| Dial_GetInput |
| Dial_InputDialog |
Related topics
Troi Dialog Plug-in online help (overview)
