Previous Topic

Next Topic

InputCustomCode - MaxBasic Function

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.

See Also

Input Functions

Book Contents

Book Index