Interface RowRangeDisplay


public interface RowRangeDisplay

Grid row-range and row-count display

ListGrids are able to create a specialized label that will display the currently visible range of rows in the viewport along with a total row count for the current data set.

When progressive loading is active, the reported row count for list grid's data may not accurately reflect the true number of rows in the data set.

See RowCountStatus for more details. Note that for custom dataSources where progressive loading is active, the DSResponse.estimatedTotalRows may be used to explictly provide either an estimated or exact row count for the data set (distinct from the reported DSResponse.totalRows.

When the true size of the data set is not known, the rowRangeDisplay will format the reported length in a way that indicates it is not an exact count (see ListGrid.getFormattedRowCount()). If ListGrid.autoFetchRowCount is set to true, a separate row count fetch will be intiated as soon as data arrives, so an accurate row count will be displayed as soon as that fetch completes. Alternatively, if ListGrid.canRequestRowCount is set to true, the user may click the label to issue a row count fetch request and get back an accurate row count to display to the user.

As an alternative to using the rowRangeDisplay autoChild, developers may also make use of various list grid APIs such as ListGrid.getRowCountStatus(), ListGrid.getRowCount(), ListGrid.getRowRangeDisplayValue() and ListGrid.fetchRowCount() to directly display or retrieve row counts.

See Also: