Drop down list Custom Token display types create a drop down list of comma separated choices entered in the Choices section of the Edit custom token dialog Display category. The drop down list is useful to choose and display a value from a list of predefined entries. In the steps below we will describe how to create a drop down list for use in a layout.
1. Navigate to the Tutorial Sample Data folder from the File tab→Open.
2. Open the layout Dropdownlist Custom Token.fey.
The layout only contains a Custom Tokens window. We will use the predefined Custom Tokens in the window to work with the Drop down feature.
3. Drag and drop the Drop Down List Custom Token from the Custom Token window onto the layout to insert it.
A text box containing the text "This will be our Drop down List Custom Token" will appear as in Figure T5.68 below:
Figure T5.68 The Dropdown list Custom Token inserted in the layout.
4. Double-click on the token text of "This will be our Drop down List Custom Token" to open the Edit Token dialog.
5. Choose Drop down list from the Display type drop down menu within the Display category (Figure T5.69).
Figure T5.69 Choosing the Dropdown list display type from the drop down list.
6. Type "Option 1, Option 2, Option 3" in the Choices (comma separated): field (Figure T5.70).
The Edit Drop Down List Custom Token dialog should look like figure 3. Notice that our choices for "Option 1 - Option 3" are separated by commas. Any text, tokens, or Custom Tokens may be entered in the dialog as drop down choices as long as they are separated by commas.
Figure T5.70 The Edit Drop Down List Custom Token dialog after entering a comma separated list of options to display in the Dropdown list.
7. Click OK.
8. Click on the drop down arrow within the text box to reveal the Drop down choices.
We will now place the Custom Token elsewhere on the layout and observe how making a choice from the Drop down list updates the token value.
9. Drag and drop the Drop Down List Custom Token from the Custom Token window onto the layout to insert it.
10. Click on the drop down arrow within the text box containing the Drop down list to reveal the Drop down choices.
11. Choose Option 2.
12. Choose Option 3.
Notice that the newly inserted text box containing the token from Step 9 now reflects the value selected from the Drop down list Custom Token display type (Figure T5.71).
Figure T5.71 The text "Option 3" appears underneath the selected Dropdown list Custom Token display type because "Option 3" is selected from the list.