DataWindow page navigation

There are several global properties related to DataWindow page navigation.You can set the navigation bar at the top or the bottom of a DataWindow page by modifying the PBDataWindowNavigationBarPosition property. You can edit labels for the “QuickGo” navigation bar and the text for the current and total page counts by modifying the PBDataWindowGoToDescription, PBDataWindowGoToButtonText, and PBDataWindowStatusInfoFormat properties.

The PBDataWindowPageNavigatorType property lets you select the type of navigation bar you want to use: NextPrev, Numeric, QuickGo, or combined types. Figure 16-1 shows the default “NextPrev” navigation bar. It also displays page status information with the default text for the current and total page count. You can set the text in the PBDataWindowStatusInfoFormat property.

Figure 16-1: “NextPrev” navigation bar with page count display

Navigation bar shows doubled less than symbols to navigate to first page, a single less than symbol to navigate to the previous page, a single greater than symbol to navigate to the next page, and doubled greater than symbols to navigate to the last page. Text indicates the user is on page two of a total of seven pages.

The NextPrev navigation bar includes the “>” symbol for navigating to the next page, and the “<” symbol for navigating to the previous page. Doubled symbols are controls for navigating to the first page (“<<”) or last page (“>>”). The navigation bar folds up to display only symbols that are functional when a user displays the first or last page of a DataWindow. For example, the user cannot navigate to a previous page from the first page, and navigating to the first page is unnecessary, so the “<” and “<<” symbols do not display on the first page.

Figure 16-2 displays the “NumericWithQuickGo” navigation bar. The numeric portion of the navigation bar lists each page by its page number. You can set the PBDataWindowPageNavigatorType to “Numeric” or to “QuickGo” if you want to use these styles separately. You can also combine the NextPrev style with the QuickGo style by setting the PBDataWindowPageNavigatorType property to “NextPrevWithQuickGo”.

Figure 16-2: “NumericWithQuickGo” navigation bar and page count

Navigation bar shows numbers for each of seven pages. This is followed by a drop-down list with the "Go To" label. You can select a page number from the drop-down list to go to that page. Text at the right of the navigation bar indicates the current page number and the total number of pages.

Although the QuickGo navigation control defaults to a drop-down list, you can change this to a text box with an associated command button by setting the PBDataWindowQuickGoPageNavigatorType property to “Button”. You can edit the button label by setting the PBDataWindowGoToButtonText property. You set the label for the text box or the drop-down list by modifying the PBDataWindowGoToDescription property.