IPFPager formatter

There are three pager types to choose from when defining the FDF: Pager, Extend, and Auto Extend.

Pager

This pager displays the current range of records in the grid. The same number of rows/columns is always shown, unless the total number of records is smaller than the displayed area or paging has reached the end of available records. At the bottom of the page, clickable arrows are displayed: "<<" and ">>" cause a one-page scroll and "<" and ">" cause a one-record scroll. The displayed range of records is updated even when direct API calls are used to switch the first displayed item index. The arrows are not clickable when there are no additional records available.

Extend

When invoked by the user, this pager adds a page of rows/columns to the current display of records. The grid is expanded with the new rows/columns when an inner FDF is invoked. The clickable arrows used with the Pager type are not displayed on the page. Instead, the inner FDF, such as a clickable Show More button, handles the user interface for the control. You must specify a UI Field Display Format of text, button, or image for the inner FDF.

Auto Extend

This pager adds a page of rows/columns to the grid automatically as the user navigates through the records. A page is automatically fetched when there are less than a set number of rows/columns outside the visible part of the grid, and the grid is expanded with these new rows/columns. You must specify an auto extend threshold percentage, and then these calculations are used to determine when a fetch is needed:

  • For horizontal orientation grids: When the number of rows outside of the visible part of the grid is fewer than Ceiling((RowsPerPage * AutoExtendThreshold) / 100)
  • For vertical orientation grids: When the number of columns outside of the visible part of the grid is fewer than Ceiling((ColumnsPerPage * AutoExtendThreshold) / 100)

With the Auto Extend pager, there is an Auto Fetches Until Manual option that allows you to specify how many times automatic fetches should be triggered until the fetching process has to be restarted manually. If you use this option, the fetching process is restarted by invoking the UI Field Display Format, similar to the Extend pager type. After the fetching has been manually invoked, another page of rows/columns is fetched into the grid and the automatic grid extension is resumed until this number of automatic fetches has been triggered again.