refreshEntries

refreshEntries(obj: Object);

The refreshEntries method of the ComboBox, ListBox, and Table class refreshes the list of entries when a collection is attached to the control. For the Table class, this method applies only to the current sheet of the table.

This method is equivalent to what happens when an update notification is processed. If the obj parameter has a non-null value, the display is refreshed so that the requested object is included in the visible portion of the list box or table.

For a combo box or list box, the listIndex property is set to the list entry for that object. For a table, the current row of the sheet is set to the row for that entry.

Calling this method discards any outstanding automatic notifications that would repeat the refreshing process. (It does not discard any future update notifications.)

You could use this method in the following situations.

When logic has just added a new entry to the collection that is required to be displayed. If the control performs an automatic update on the display, the notification will not arrive until current event logic completes or an app.doWindowEvents is performed, and it cannot be guaranteed that it will arrive immediately if the server is very busy.

Calling the refreshEntries method updates the display and ensures that the new entry is included in the list.
To force a refresh of the entries displayed when data for an entry or entries has been changed so that it will not result in a notification (the collection is unchanged).

Calling refreshEntries refreshes the displayed list using the updated objects.