Bewerken

Share via


ICollectionViewLiveShaping Interface

Definition

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

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.

Applies to