Design › Designing Client Procedures › Lesson Activity › eGolfer Home › Add the List Box

Add the List Box

Follow these steps:

1. To add the List Box, from the Menu Bar select Edit, and then select List Box Design…. In the List Properties dialog, make sure the Export View: EXPORT GROUP OF SCORING RECORDS is mapped to the Import View: IMPORT GROUP OF SCORING RECORDS. List Boxes are added to the window design all at once, and it is easier to define all of the field and prompt properties prior to adding them.
2. First of all, check to make sure the fields are in the order you want them to appear in the list box on the window. In our case, we want them to be in the following order:
   1. SELECT CHAR
   2. DATE
   3. TIME
   4. ADJUSTED GROSS SCORE
   5. COURSE RATING
   6. COURSE SLOPE RATING
   7. NOTE

   If they are not in the correct order, select the attribute you want to move, select the Move push button, and then select the attribute you want to move the selected attribute directly beneath. If you have multiple attributes to move, you will need to unselect the previous one before attempting to move the next one.

3. The next thing we want to do is define the Properties for each attribute. Unselect any selected attributes and then select the SELECT CHAR. Select the Properties… push button. If the Properties… push button is not enabled, then it is because you have more than one attribute selected. In the List Box Field Properties dialog, if the Import View: indicates [none], ignore it. Check the check box indicating that we want to use this field for the Selection Indicator. While this field will not explicitly be placed on our window design, it will be used to keep track of highlighted/selected fields. Select the OK push button.
4. Unselect SELECT CHAR, select DATE, and select the Properties… push button. If necessary, add the prompt Date. Then change the Prompt Align: to Center, select the Edit Pattern: MM/DD/YY, change the Edit Align: to Center, and then select the OK push button.
5. Unselect DATE, select TIME, and select the Properties… push button. If necessary, add the prompt Time. Then change the Prompt Align: to Center, add the Edit Pattern: HH:MM, change the Edit Align: to Center, and then select the OK push button.
6. Unselect TIME, select ADJUSTED GROSS SCORE, and select the Properties… push button. Then add the prompt Score, then change the Prompt Align: to Center, add the Edit Pattern: ZZZ, change the Edit Align: to Center, and then select the OK push button.
7. Unselect ADJUSTED GROSS SCORE, select COURSE RATING, and select the Properties… push button. Then add the prompt Rating, change the Prompt Align: to Center, add the Edit Pattern: ZZ.Z, change the Edit Align: to Center, and then select the OK push button.
8. Unselect COURSE RATING, select COURSE SLOPE RATING, and select the Properties… push button. Then add the prompt Slope, change the Prompt Align: to Center, add the Edit Pattern: ZZZ, change the Edit Align: to Center, and then select the OK push button.
9. Unselect COURSE SLOPE RATING, select NOTE, and select the Properties… push button. Then add the prompt Note, leave the Prompt Align: to Left, leave the Edit Pattern: <Default Edit Pattern>, leave the Edit Align: Default, and then select the OK push button.
10. Since the entire Note will not appear on the window, select Horizontal Scroll. Then select Adjust Position so that only whole lines will appear in the List Box. We only want to allow Single Selections.
11. To identify which fields to actually use in the list box, select all of the attributes except the SELECT CHAR, and then select the Include push button.
12. Finally, to add the list box to the window design, select the OK push button and place it onto the window. The list box will be positioned to cover the entire width of the window. Resize it by using the right mouse button to drag it slightly off center, and then select an edge of the list box and drag it to the proper size. Use the window example shown earlier to gauge your dimensions.

    You may have to slightly resize a column to get the entire field to display. If so, slowly move your mouse between two columns in the list box until it turns into a double-sided arrow. Then click-and-drag the column to the desired width. You may also have to resize the prompts by selecting one of them on the window, and then slightly resizing the box they appear in. If something does not look quite centered, or the edit patterns are not what you thought they should be, double-click on the list box to open it is List Properties panel and review each individual attribute's properties once again.

13. Add a group box around the scoring records list box, making sure to leave room for the push buttons. Name the group box Scoring Record.
14. Add three push buttons named add, update, and remove. The add push button should execute an event named open add scoring record db, the update push button should execute an event named open update scoring record db, and the remove push button should execute an event named open remove scoring record db. Make the add push button the default push button for this window by selecting the Is the Default Push Button check box.
15. Add a logout push button to the bottom of the window. Add an event for it, letting the Toolset generate the event name.