ICollectionViewLiveShaping Interface

Definition

Namespace:

System.ComponentModel

Assembly:

WindowsBase.dll

Defines properties that enables sorting, grouping, and filtering on a CollectionView in real time.

public interface class ICollectionViewLiveShaping

public interface ICollectionViewLiveShaping

type ICollectionViewLiveShaping = interface

Public Interface ICollectionViewLiveShaping

Derived

System.Windows.Controls.ItemCollection

System.Windows.Data.BindingListCollectionView

System.Windows.Data.ListCollectionView

Remarks

When live sorting, grouping, or filtering is enabled, a CollectionView will rearrange the position of data in the CollectionView when the data is modified. For example, suppose that an application uses a DataGrid to list stocks in a stock market and the stocks are sorted by stock value. If live sorting is enabled on the stocks' CollectionView, a stock's position in the DataGrid moves when the value of the stock becomes greater or less than another stock's value.

The ListCollectionView, BindingListCollectionView, and ItemCollection classes implement the ICollectionViewLiveShaping interface. The CollectionViewSource class also implements the properties defined by ICollectionViewLiveShaping to enable setting the properties in XAML.

Notes for Inheritors

Implement this interface on your custom CollectionView to support sorting, grouping, and filtering data in real time. Your CollectionView can implement the sorting, grouping, and filtering operations itself, or you can delegate one or more of them to another object, such as the underlying collection. If you delegate the shaping operations, the CollectionView might not have control over whether live shaping is enabled. Your CollectionView must accept the behavior of the object to which it delegates. In this case, set the appropriate CanChange* properties to false. If your CollectionView knows whether the delegate object supports live shaping, it can set the appropriate IsLive* properties to the known value. Otherwise, the CollectionView should set the IsLive* properties to null.

Properties

CanChangeLiveFiltering	Gets a value that indicates whether the collection view supports turning filtering data in real time on or off.
CanChangeLiveGrouping	Gets a value that indicates whether the collection view supports turning grouping data in real time on or off.
CanChangeLiveSorting	Gets a value that indicates whether the collection view supports turning sorting data in real time on or off.
IsLiveFiltering	Gets or sets a value that indicates whether filtering data in real time is enabled.
IsLiveGrouping	Gets or sets a value that indicates whether grouping data in real time is enabled.
IsLiveSorting	Gets or sets a value that indicates whether sorting in real time is enabled.
LiveFilteringProperties	Gets a collection of strings that specify the properties that participate in filtering data in real time.
LiveGroupingProperties	Gets a collection of strings that specify the properties that participate in grouping data in real time.
LiveSortingProperties	Gets a collection of strings that specify the properties that participate in sorting data in real time.