Changes
Refactoring of article layout for clarity. Added some missing xaml impls
{{Hint|When multiple filters are used at the same time, they are combined with "logic and".}}
For exampleperformance/usability reasons, the result list is not immediately refreshed as one types in the text box. One can customize Instead, it only happens after the ChildArea ReloadChildListCommand is triggered. However, note that these content-based filters:* Require a custom [[SYSCLS_CHILDAREATEMPLATE|Child Area template name]] to work. This customizing will not work applied to include the followingUBIKChildArea.* Work directly on the Children.Items collection. While filters are active, anything derived from this collection (such as Children.Items.Count or custom datasources like [[XAML_Changes_in_UBIK_WinX_3.5#Filtering_by_expressions|ListCollectionView]] / [[Xamarin_XAML#Content_filtering|sfDataSourceExt]]) will also be affected.<br><br> == Usage ==For simple text input, it is enough to create a text input control with a TwoWay relationship to the Children.Filter[x]. However, the TwoWay binding doesn't always work well with more advanced implementations, such as selection. In such cases, the alternative is to use the UpdatePropertyFiltersCommand to supply the filter criteria. Both approaches are described below. === Text Input ===<tabs> <tab name="UWP">
<source lang = "xml">
</source>
</tab>
<tab name="Xamarin">
<source lang = "xml">
<Entry
Placeholder="Filter by Name"
Text="{Binding Children.Filters[DESCR], Mode=TwoWay, Converter={StaticResource FilterCriterionToValue}}"/>
</source>
</tab>
</tabs>
This is shown as a single text box. The two way binding on Text allows the entered text (case insensitive) to be used as the filter value on property "SomePropertyName" (case sensitive).
<br>
<tabs>
<tab name="XamarinUWP">
<source lang = "xml">
<Grid xmlnscontrols:ctrls="clr-namespaceComboBoxExt x:UBIK.CPL.Controls;assemblyName=UBIK.CPL"ComboBox" xmlns:classes PlaceholderText="clr-namespace:UBIK{Binding Children.CPLFilters[STATUSCOLOR].Classes;assemblyValue, FallbackValue=UBIK.CPL'SELECT'}"> <ctrls:PickerExtDisplayMemberPath="DisplayText" x:Name SelectedValuePath="FilterDisplayText" ItemsSource SelectedValue="{Binding PropertiesChildren.AllItemsFilters[QUERYSTATUSCOLOR].LinkedLevel.Children.ItemsValue}" ItemDisplayBinding SelectedValueExt="{Binding HeaderChildren.Filters[STATUSCOLOR].Value}" SelectionChangedCommand ItemsSource="{Binding Children.UpdatePropertyFiltersCommandItems[1].Properties.AllItems[STATUSCOLOR].MetaProperty.SelectiveList, Converter={StaticResource SelectiveListToItemsConverter}}"> <interactivity:Interaction.Behaviors> SelectedValuePath<core:EventTriggerBehavior EventName="UIDSelectionChanged"> SelectedValue <core:InvokeCommandAction Command="{Binding Children.Filters[STA].Value, Mode=OneWayUpdatePropertyFiltersCommand}"> <ctrlscore:PickerExtInvokeCommandAction.SelectionChangedCommandParameterCommandParameter> <classescontrols:KeyValueList> <classescontrols:KeyValueParameter Key="ClearPropertyFilters" Value="false" /> <classescontrols:KeyValueParameter Key="STASTATUSCOLOR" Value="{Binding Path=SelectedItem.UIDDisplayText, SourceElementName={x:Reference Filter}ComboBox}" /> </classescontrols:KeyValueList> </ctrlscore:PickerExtInvokeCommandAction.SelectionChangedCommandParameterCommandParameter> </core:InvokeCommandAction> </core:EventTriggerBehavior> </ctrlsinteractivity:PickerExtInteraction.Behaviors></Gridcontrols:ComboBoxExt>
</source>
Note that several elements are required for this customization to work:* SelectedValuePath informs the control of which property should be supplied to the command as a filter criteria. This should match what is supplied in your KeyValueParameter.* DisplayMemberPath informs the control of which property should be visualized as the displaytext of your selection.* PlaceholderText binds to the same value as your SelectedValueExt to display the current selected item. This is a workaround for a failure of the ComboBox control to correctly display an active selection when the control is rendered. </tab> <tab name="UWPXamarin">Not yet available. </tab><source lang = "xml"> xmlns:ctrls="clr-namespace:UBIK.CPL.Controls;assembly=UBIK.CPL"xmlns:classes="clr-namespace:UBIK.CPL.Classes;assembly=UBIK.CPL">
<ctrls:PickerExt
x:Name="Filter"
ItemsSource="{Binding Properties.AllItems[QUERY].LinkedLevel.Children.Items}"
ItemDisplayBinding="{Binding Header}"
SelectionChangedCommand="{Binding Children.UpdatePropertyFiltersCommand}"
SelectedValuePath="UID"
SelectedValue="{Binding Children.Filters[STA].Value, Mode=OneWay}">
<ctrls:PickerExt.SelectionChangedCommandParameter>
<classes:KeyValueList>
<classes:KeyValueParameter Key="ClearPropertyFilters" Value="false" />
<classes:KeyValueParameter Key="STA" Value="{Binding Path=SelectedItem.UID, Source={x:Reference Filter}}" />
</classes:KeyValueList>
</ctrls:PickerExt.SelectionChangedCommandParameter>
</ctrls:PickerExt>
</source>
</tabs>
The example above uses a UBIK.CPL.Controls.PickerExt custom ComboBox/Picker control to display a list of query result objects (through the "QUERY" property's LinkedLevel)items. The UID chosen aspect of the of the selected object is then passed on as a part of the command parameter and later used as a filter criterion to filter for objects that have their "STA" property value containing the UID same the string. This approach makes use of the Children.UpdatePropertyFiltersCommand, which uses the following parameters:
* ClearPropertyFilters: Clear out all existing filters at the current level before executing the command. This is optional and defaults to false;
* All other parameters: Used KeyValue pairs used as filter criteria where the Keys are the names of the properties metaproperties by which you want to filter.
<br>
=== Evaluation Criteria ===
By default, the expression used for filtering is Content["PROPERTY_NAME"].DisplayValue.ToLower().Contains(FILTER_VALUE.ToLower())==true.
In other words, it checks whether the specified filter value (as string) is contained in the display value of the property.
In more advanced scenarios where a different type of comparison is needed, the example (or more specifically the one KeyValueParameter) can be extended into the following, e.g. comparing whether the specified filter value is equal to the value of the property.
<classes:KeyValueParameter Key="STA" Value="{Binding Path=SelectedItem.UID, Source={x:Reference Filter}, Converter={StaticResource FilterValueToCriterion}, ConverterParameter=Content[\"\{0\}\"].Value.ToString().Equals(\"\{1\}\")\=\=true}" />
</source>
{{Hint|"&quot;" and "\" are used for escaping the special characters in XAML and C# code respectively. "{0}" and "{1}" are placeholders and get replaced by the property name and the filter value. The end expression being executed in this example is <code>Content["PROPERTY_NAME"].Value.ToString().Equals(FILTER_VALUE)==true</code>}}
[[Category:2.6.1|Property Based Content Filters]]
