Script Steps Reference

Table Of Contents
122 FileMaker Script Steps Reference
Select Use password character (*) to mask text as it is entered, or as it is displayed
from the database. This option obscures data being input into the custom dialog box
or being displayed, but does not alter the actual data as it is stored in the database.
Use Label to specify a field label (the text that will identify this input to the user.) You
can enter literal text or create the label from a calculation.
Web compatibility
This script step is not web-compatible.
Description
Displays a custom message dialog box, with custom text and labels. The custom dialog
box can take user input for up to three fields in the database, and display data from up to
three fields in the database. The script pauses as long as the custom dialog box stays on
the screen. Fields used for input can be of type text, number, date, time, timestamp, or
container. Your custom dialog box can also have up to three buttons, with custom button
titles.
Use the Get(LastMessageChoice) function to determine which button the user presses.
1 represents the rightmost button
2 represents the middle (or second) button
3 represents the leftmost button
Button 1, the default or rightmost button, is the only button that will write information from
the input fields to a file.
Notes
If values entered into input fields don’t match the field type, a validation error
message displays. The user must resolve validation errors before the dialog box can
be closed. See FileMaker Pro Help for more information.
The fields you specify don’t need to appear on the current layout. Show Custom
Dialog input fields are independent of layouts, similar to the Set Field script step.
Data can't be inserted into calculation or summary fields.
As with Set Field script step on page 45, Show Custom Dialog will bypass the Allow
entry into field field formatting option.
Data entry via the Show Custom Dialog script step is limited by any access privileges
rules that may be in place. (Select Run script with full access privileges to enable
the script for all users.)
(Windows) You can create a keyboard shortcut for a custom dialog box button by
placing an ampersand before the shortcut key letter in the button label. For example,
to create a keyboard shortcut ‘D’ (Alt+D) for a button labeled ‘Done’, type the label
‘&Done’.