Page tree
Skip to end of metadata
Go to start of metadata

Auto-complete, also referred to as auto-suggest, is a feature that suggests values in a dropdown list as you type into a textbox. In Profound UI, textbox widgets have a set of auto-complete properties that can either provide a static suggestion list or link to a database for suggestions.

To enable scrolling for the auto-complete choices, you must specify the 'max height' property for the textbox.

 

Auto-Complete Choices

These properties allow you to provide a static or program provided list of auto-complete choices.

Choices

Specifies the options for a textbox with auto-complete. The options should be comma separated. The first option cannot be empty.
Promptable? YES
Possible Values: Comma separated list of valid choices
Bindable? YES
Product: Profound UI, Genie

Choice Values

Specifies alternate option values to send to the application for a textbox with auto-complete. The values should be comma separated. The first option cannot be empty.
Promptable? YES
Possible Values: Comma separated list of valid values to be returned to application.
Bindable? YES
Product: Profound UI, Genie

Database-Driven Auto-Complete

These properties allow you to provide the needed information to retrieve the list of auto-complete choices from a database file.

Choices Database File

Database file to be used for a dynamic database-driven textbox with auto-complete.
Promptable? NO
Possible Values: Any valid database file name. Can be specified with library in 'LIBRARY/FILE' format.
Bindable? YES
Product: Profound UI, Genie

Choice Options Field

Database field name used to retrieve the options for a textbox with autocomplete. Multiple fields can be specified and should be comma separated.
Promptable? YES
Possible Values: Any valid database field name(s) from the Choices Database File
Bindable? YES
Product: Profound UI, Genie

Choice Values Field

Database field name used to retrieve the values sent back to the application. If omitted, the choice options field is used. If multiple option fields were specified, the first option field is returned.
Promptable? YES
Possible Values: Any valid database field name from the Choices Database File
Bindable? YES
Product: Profound UI, Genie

Choices Selection Criteria

Optional expression identifying which records should be retrieved from the choices database file.
Promptable? YES
Possible Values: Any valid selection criteria for the Choices Database File. Selection criteria should be formatted like a SQL "Where" clause.
Bindable? YES
Product: Profound UI, Genie

Choices Parameter Value

Value used for parameter markers specified in the 'Choices Selection Criteria' property. Parameter markers are specified in 'Choices Selection Criteria' by using a question mark ( ? ). 
Promptable? YES
Possible Values: Any valid value that can be used as a parameter for an SQL "Where" clause. 
Bindable? YES
Product: Profound UI, Genie

Max Choices

Optional maximum number of choices to provide for auto-complete. This property controls the size of the auto-complete dropdown list. If not set it defaults to 10.
Promptable? NO
Possible Values: Any positive integer value
Bindable? YES
Product: Profound UI, Genie

Contains Match

When set to true, the auto-complete query finds records that contain the search text. When set to false, the auto-complete query finds records that start with the search text. The default is false.
Promptable? DROPDOWN
Possible Values: True, False
Bindable? YES
Product: Profound UI, Genie

Case Sensitive

When set to true, the auto-complete query does not convert the search text or database search column to upper case before comparing. When false, the database column and search text are converted to upper case before comparing. The default is false.
Promptable? DROPDOWN
Possible Values: True, False
Bindable? YES
Product: Profound UI, Genie

Dynamic Auto-Complete

This method allows auto-complete choices to be retrieved from a web service.

Choices URL

Sets the url to a Web service that returns the choice options and values in JSON format. The service can be provided with Profound Logic's RPGsp or another web development framework. RPGsp provides an easy to use platform for developing Web services using ILE RPG. If a choices URL is used, the database file, choice options field, choice value field, and max choices properties are ignored. A POST parameter named "query" is automatically submitted to the URL that contains the current contents of the widget that is using this property; this is updated every time a request to the URL is made such as on every keystroke within the widget.
Promptable? YES
Possible Values: A valid web service URL
Bindable? YES
Product: Profound UI, Genie

Events

Onselect

Initiates a client-side script when a selection is made form the selection list of an auto-complete textbox or a combo box. In the case of an auto-complete textbox, the selected record is passed to the function as a JSON object that has properties named after the selected fields.
Promptable? YES
Possible Values: Any valid JavaScript code
Bindable? YES
Product: Profound UI, Genie

  • No labels