It takes a minimum of three steps to create and set up a simple Text List object.
This movie illustrates these three steps, then shows the Text List object in use.
By the way, in addition to creating a Text List object manually like this, you can also create one using a template using the Text List Constructor. This is often the fastest way to create a Text List object.
The Formula panel is used to specify the list of data items that will appear in the object. In the example above, this was a fixed list. Each line generated by the formula becomes a row.
In this example the list is fixed and unchanging, but that is unusual. In most applications the formula will be set up to get the text from a variable, a field, or thru a more complex calculation. This example uses the listfiles( function to display a scrollable list of all the applications in the computer’s main Applications folder.
It’s very common to set up a formula to use a database as the source of the data for the list. See Text List Database Integration for details on how to do this.
If your formula has a problem it can be a bit tricky to figure out what’s wrong since you can’t directly see the text produced by the formula. In that situation you can use the Object Value dialog to display the entire formula result. See Diagnosing a Formula embedded in a Form Object to learn how to use this dialog.
You must set up a field or variable that will be linked to the selected value in the list. (There is one exception – no variable is needed if you are using the Database Navigator option, see Text List Database Integration.) In this example, selected value is linked to a fileglobal variable named targetApplication.
Whenever an item in this list is clicked, the value in the targetApplication variable is updated. To illustrate this, a Text Display Object that displays the targetApplication variable has been added to this form. As different items are clicked, they appear in the Text Display Object.
Note that if the user selects an item in the Text List that appears more than once, all of the matching items will be selected and assigned to the Text List Variable. To learn more about selecting items in a Text List, including using the keyboard for selection and selecting multiple items, see Text List Selection.
This page just scratches the surface of the capabilities of a Text List object. To learn more see these topics:
There also a detailed training video covering these objects:
|10.0||New||New in this version.|