Dial_SetInput (function reference)

By October 1, 2017 November 14th, 2018 Online Help, Troi Dialog Plug-in
Troi Dialog Plug-in for FileMaker Pro

Dial_SetInput

Sets the text to be pre-entered in the input fields of the next input dialog.

SyntaxFunction badge

Dial_SetInput ( switches ; text1 ; text2 ; text3 ; text4 ; ... ; text15 )

Parameters

switchesnot used, reserved for future use. Leave blank or put "-Unused"
text1…text15the text that will be pre-entered into the input fields 1 to 15

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 12 to 17

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, text

Add the following script step:

Set Field [ result ; Dial_SetInput ( "-Unused" ;  Get ( UserName ) ;  gFieldText ; ) ]

Related functionsFunction badge

Dial_GetButton
Dial_GetInput
Dial_InputDialog

Related topics

Troi Dialog Plug-in online help (overview)


Online Help Page for Troi Dialog Plug-in for 14 to 17 –> Dial_SetInput (dialp4312) 2018-1114 15:08:56