InputCustomCode(CustomTable: String, Prompt: String[, Title: String, Default: String, Filter: String, FilterButtonVisible: Boolean, AllowEmpty: Boolean, UseExactMatch: Boolean]): String
Displays a prompt in a dialog box, User must input or select a correct code or click a button, returns a string containing the contents of the code box.
Notes: If User clicks OK or presses Enter, InputCustomCode function returns what is in the look-up control (empty string "" if no value entered). If User clicks Cancel or presses Esc, function returns Null. The Code field is identified by being the single field in the first primary or unique index on the table, or the first field if that fails.
InputCustomCode function syntax has these named arguments:
Parameter |
Description |
|---|---|
Custom Table |
Required. Custom table name or memory table object used to select the custom code to be entered. |
Prompt |
Required. String expression displayed as the message in the dialog box. |
Title |
Optional. String expression displayed in the title bar of the dialog box. If you omit title, the application name is placed in the title bar. |
Default |
Optional. Code displayed in the look-up control as the default response if no other input is provided. If you omit default, the look-up control is displayed empty. |
Filter |
Optional. Filter expression for limiting available master file codes. |
Filter Button Visible |
Optional, defaults to True. Determines if the filter button is available on the control. |
Allow Empty |
Optional, defaults to False. Determines if the Lookup can be cleared after a value has been selected. |
Use Exact Match |
Optional, defaults to True. Determines if the Lookup can accept and return values not in the code list. |
Note: You can load and save customisations to the drop-down list by right-clicking in the list and selecting
Customise.
See also Scripted Form InputCustomCode method and Input Grid InputCustomCode method.