We recommend that you use the xamDataGrid control instead of the xamGrid control. The xamGrid is being planned for retirement over the next few years and will not receive any new features. We will continue to provide support and critical bug fixes for the xamGrid during this time. For help or questions on migrating your codebase to the xamDataGrid, please contact support.
The Column Chooser feature allows your end users to change the visibility of columns in the xamGrid control at run time.
Column Chooser displays a list of column headers along with the column chooser icon. Your end users can click the column chooser icon within a column header to hide that particular column.
When a particular column is hidden, the column chooser indicator will appear to the right of the adjacent column. When this indicator is clicked, a drop-down will appear with the hidden column(s) displayed.
In addition, if you are binding your xamGrid control to a hierarchical data source, the column chooser feature will allow your end user to toggle the visibility of a column layout from the column chooser dialog window.
The xamGrid control offers several options to display the column chooser dialog window.
The user clicks on the hidden column indicator and selects the Column Chooser label from the column chooser drop-down list.
Invoke the ShowColumnChooser() or ShowColumnChooser(ColumnLayout) methods. If you want to specify the location where the column chooser should display, you can also invoke the ShowColumnChooser(Point) or ShowColumnChooser(ColumnLayout, Point) methods. When using the ColumnChooser and the GroupColumn feature (for more information, see Group Column), you can display the column chooser by invoking the ShowColumnChooser(Column) method.
The column chooser dialog window can be hidden in the following ways:
Your end users can click the Close button that is displayed on the column chooser dialog window.
Invoke the HideColumnChooser() method.
If the last column is hidden, the column chooser indicator will appear on the right of the last visible column’s header. Clicking this indicator will display all the hidden columns to the right of that particular column.
The screenshot below shows the key features of the column chooser feature.
Column Chooser Indicator
Column Chooser Hide Icon
Column Chooser Drop Down List
Column Chooser Button
The following screenshot shows the key features of the column chooser dialog window.
Hidden Column
Icon used to reorder columns
Related Topics