BuyLog In
Breaking Change T851310
Visible to All Users

Pager and Data Grid's Pager - The navigation mode has been changed, and the CollapseButtonCount property has been removed

In previous versions, the standalone DxPager component and the DxDataGrid component's built-in pager always displayed numeric buttons. If the total number of pages exceeded the DxPager.CollapseButtonCount/DxDataGrid.PagerCollapseButtonCount value, the pager skipped specific numeric buttons and displayed an ellipsis instead.

pager-old-behavior.png

In v19.2, we redesigned the pager's interface to make it more intuitive and changed the default navigation mode to simplify navigation across a large number of pages. The pager will no longer display ellipsis buttons. For this reason, we removed the DxPager.CollapseButtonCount and DxDataGrid.PagerCollapseButtonCount properties.

We introduced the new DxPager.SwitchToInputBoxButtonCount and DxDataGrid.PagerSwitchToInputBoxButtonCount properties. The pager now shows the Go to Page input box if the number of pages is greater than the corresponding property value.

pager-input-box.png

Otherwise, the pager displays numeric buttons. The new DxPager.VisibleNumericButtonCount and DxDataGrid.PagerVisibleNumericButtonCount properties specify the maximum number of visible buttons. To navigate to other numeric buttons, a user should use the arrow navigation buttons.

pager-numeric-buttons.png

We also added the DxPager.NavigationMode and DxDataGrid.PagerNavigationMode properties that allow you to change the navigation mode. These properties accept the following values:

  • Auto - the default mode described above.
  • InputBox - the pager always displays the Go to Page input box.
  • NumericButtons - the pager always displays numeric buttons.

The following code snippet demonstrates how to use the new pager API.

Code
<DxPager PageCount="100"  
         ActivePageIndex="50"  
         NavigationMode="PagerNavigationMode.NumericButtons"
         VisibleNumericButtonCount="7">  
</DxPager>

Disclaimer: The information provided on DevExpress.com and affiliated web properties (including the DevExpress Support Center) is provided "as is" without warranty of any kind. Developer Express Inc disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

Confidential Information: Developer Express Inc does not wish to receive, will not act to procure, nor will it solicit, confidential or proprietary materials and information from you through the DevExpress Support Center or its web properties. Any and all materials or information divulged during chats, email communications, online discussions, Support Center tickets, or made available to Developer Express Inc in any manner will be deemed NOT to be confidential by Developer Express Inc. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.