Skip to content

Commit 7a4d238

Browse files
committed
update common article
1 parent 3eab836 commit 7a4d238

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

common-features/data-binding/descriptors.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ This article explains how to retrieve the applied filtering, searching, sorting,
1515
* The [Filter]({%slug filter-overview%})
1616
* The [Gantt]({%slug gantt-overview%})
1717
* The [TreeList]({%slug treelist-overview%})
18-
* All components that [expose the `OnRead` event]({%slug common-features-data-binding-onread%}#components-with-onread-event).
18+
* All components that [expose the `OnRead` event]({%slug common-features-data-binding-onread%}#components-with-onread-event), excluding the [ListView]({%slug listview-overview%}), because the ListView doesn't support built-in filtering, searching, sorting, and grouping.
1919

2020
## Obtain Filtering, Searching, Sorting, Grouping criteria
2121

@@ -72,14 +72,16 @@ At the bottom of the article you will find full examples.
7272

7373
## Filtering
7474

75-
The filtering criteria for each filtered field is stored in an individual collection of [`IFilterDescriptor`](/blazor-ui/api/Telerik.DataSource.IFilterDescriptor). To access the filtering criteria, cast each `IFilterDescriptor` to [`CompositeFilterDescriptor`](/blazor-ui/api/Telerik.DataSource.CompositeFilterDescriptor).
75+
The filtering criteria for each filtered field is stored in an individual collection of [`IFilterDescriptor`](/blazor-ui/api/Telerik.DataSource.IFilterDescriptor). To access the filtering criteria, such as the user input to filter by, cast each `IFilterDescriptor`:
76+
77+
* If the component is of type input or select, such as the AutoComplete, the ComboBox, the DropDownList, the MultiColumnComboBox, the MultiSelect, cast each `IFilterDescriptor` to [`FilterDescriptor`](/blazor-ui/api/telerik.datasource.filterdescriptor).
78+
* Otherwise, cast each `IFilterDescriptor` to [`CompositeFilterDescriptor`](/blazor-ui/api/Telerik.DataSource.CompositeFilterDescriptor).
79+
80+
### CompositeFilterDescriptor
7681

7782
The `CompositeFilterDescriptor` exposes:
78-
* [`FilterDescriptors`](/blazor-ui/api/telerik.datasource.compositefilterdescriptor#Telerik_DataSource_CompositeFilterDescriptor_FilterDescriptors) property. This property represents another collection of `IFilterDescriptor`. To access the filtering criteria cast the `IFilterDescriptor` to a [`FilterDescriptor`](/blazor-ui/api/telerik.datasource.filterdescriptor). Each `FilterDescriptor` instance gives access to:
79-
* The `Member`—The field where the user filters. Each filter descriptor describes also the `MemberType`, that represents the type of the field.
80-
* The `Operator`—The [`FilterOperator`](/blazor-ui/api/telerik.datasource.filteroperator) that applies. There are different operators depending on the `MemberType`. Read more about the [filter operators]({%slug common-features-filter-operators%}).
81-
* The `Value`—The user input to filter by.
82-
* [`LogicalOperator`](/blazor-ui/api/telerik.datasource.compositefilterdescriptor#Telerik_DataSource_CompositeFilterDescriptor_LogicalOperator) property. This property can be either AND or OR. This property represents the logical operator applied between the instances in the `FilterDescriptors` collection.
83+
* [`FilterDescriptors`](/blazor-ui/api/telerik.datasource.compositefilterdescriptor#Telerik_DataSource_CompositeFilterDescriptor_FilterDescriptors) property. This property represents another collection of `IFilterDescriptor`. To access the filtering criteria cast each `IFilterDescriptor` to a `FilterDescriptor`.
84+
* [`LogicalOperator`](/blazor-ui/api/telerik.datasource.compositefilterdescriptor#Telerik_DataSource_CompositeFilterDescriptor_LogicalOperator) property. This property can be either `AND` or `OR`. This property represents the logical operator applied between the instances in the `FilterDescriptors` collection.
8385

8486
When the filtering is initiated, the `CompositeFilterDescriptor` properties get different values, depending on the filter mode:
8587

0 commit comments

Comments
 (0)