Progress
AppBuilder
Developer’s Guide
Creating a Dynamic SmartDataBrowser Instance
Creating, placing, and configuring a dynamic SmartDataBrowser is a very straightforward process. Follow these steps:
- First create and place an appropriate SmartDataObject to supply the data stream the Browser will display.
- Right-click the SmartDataBrowser tool icon in the Object Palette:
![]()
Choose Dynamic SmartDataBrowser from the menu that opens.
- Position your mouse cursor over the workspace and click to place the object. It appears as a Browse widget, initially with only a single column:
![]()
- AppBuilder immediately opens an Advisor window if it finds opportunities to create SmartLinks to other objects. Examine the recommendations and accept all that seem appropriate.
- Click on the menu button and select Instance Properties from the menu. That dialog box opens:
![]()
- If you wish to display or allow updates to fewer fields than the SmartDataObject would permit, make those changes now. Choose the appropriate button to open a selector dialog. See Table 5–1 for a description of how Progress makes use of your choices.
- If you wish to allow the user to search on one of the displayed fields, select it from the Search Field combo box.
- Clear the Enable and View check boxes to initialize the object in a hidden, insensitive state.
NOTE: The design-time representation does not account for the Down and Width choices you make, so you cannot predict the run-time appearance from it. You will need to experiment to determine how to get the run-time appearance you desire. A good first approximation for number of lines might be to show 1 or 2 more lines than your Down setting (1 to account for the column-labels line, and a second if there will be a horizontal scroll bar)- Set the Down value to the number of rows you wish the Browser to display. If you wish the object to determine its own best width, check the Calculate Width box and, if desired, enter a Max Width limiting value.
- Unless the total number of records in the data stream is same or less than the Rows To Batch value, the user will not be able to use the scroll bar to reach the last record. The last record reachable by using the scroll bar is the last record in the buffer, not the last record in the data stream. This can be confusing to the user.
To solve this problem, check the Scroll Remote Results List box. You might also have to write some code. For more information see the "Scrolling to the Last Record in the Data Stream" section.
Unless you need to add special logic, the Dynamic Browser will typically be a lower-cost choice than a Static Browser.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |