FilterCheckedListPickerItem Class

A filter item that allows users to select items from a checked list shown in a separate dialog.

Assembly : DevExpress.Maui.Editors.dll

NuGet Package : DevExpress.Maui.Editors

Declaration

csharp

[DXLicenseMAUI]
public class FilterCheckedListPickerItem :
    FilterListPickerItemBase

Remarks

The image below shows a sample filter item with a checked list. Users can enter a search query in the search box to filter available options:

To use a FilterCheckedListPickerItem in your filtering UI, bind its Context property to the data control’s FilteringContext (DataGridView.FilteringContext or DXCollectionView.FilteringContext). Then specify the FilterCheckedListPickerItem’s FieldName property to set by which data source property values the data control should filter its items:

XAML

xaml

<ContentPage ...
             xmlns:dxe="clr-namespace:DevExpress.Maui.Editors;assembly=DevExpress.Maui.Editors">
             <!--...-->
                 <dxe:FilterCheckedListPickerItem Context="{Binding}" FieldName="Status"/>
             <!--...-->
</ContentPage>

csharp

FilterPage FilterPage => filterPage ??= new FilterPage() { BindingContext = dataControl.FilteringContext };

The FilterCheckedListPickerItem shows its list of options on a separate page. As an alternative, use the FilterCheckedListItem to show a checked list of available options on the same page. If you need users to select a single option, consider using a FilterRadioListItem or FilterRadioListPickerItem.

To show check boxes for items, set the ShowCheckBoxes property to true.

You can also replace the default editor with a custom editor. To do so, specify the FilterCheckedListPickerItem ‘s FilterModelTemplate property. Use the FilterCheckedListPickerItem ‘s FilterModel property to obtain the binding context for the template.