ICollectionViewLiveShaping インターフェイス

定義

CollectionView に対するリアルタイムの並べ替え、グループ化、およびフィルタリングを可能にするプロパティを定義します。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
派生

注釈

ライブ並べ替え、グループ化、またはフィルター処理が有効になっている場合、データが変更されたときに、CollectionView によって CollectionView 内のデータの位置が再配置されます。When live sorting, grouping, or filtering is enabled, a CollectionView will rearrange the position of data in the CollectionView when the data is modified. たとえば、アプリケーションが DataGrid を使用して株式市場の株式を一覧表示し、株式が株価によって並べ替えられるとします。For example, suppose that an application uses a DataGrid to list stocks in a stock market and the stocks are sorted by stock value. 株式の CollectionView でライブ並べ替えが有効な場合、株式が別の株式の価格を上回るか下回ると、DataGrid における株式の位置が移動します。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.

ListCollectionView インターフェイスは、BindingListCollectionViewItemCollectionICollectionViewLiveShaping の各クラスで実装されています。The ListCollectionView, BindingListCollectionView, and ItemCollection classes implement the ICollectionViewLiveShaping interface. CollectionViewSource クラスは、ICollectionViewLiveShaping によって定義されたプロパティも実装して、XAML でプロパティを設定できるようにします。The CollectionViewSource class also implements the properties defined by ICollectionViewLiveShaping to enable setting the properties in XAML.

継承に関する注意事項Notes for Inheritors

リアルタイムでのデータの並べ替え、グループ化、およびフィルター処理をサポートするには、カスタム CollectionView にこのインターフェイスを実装します。Implement this interface on your custom CollectionView to support sorting, grouping, and filtering data in real time. CollectionView は、並べ替え、グループ化、およびフィルター処理の各操作を実装できます。また、基になるコレクションなど、1つ以上のオブジェクトを別のオブジェクトに委任することもできます。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. 整形操作を委任する場合、CollectionView はライブシェイプが有効かどうかを制御できない可能性があります。If you delegate the shaping operations, the CollectionView might not have control over whether live shaping is enabled. CollectionView は、デリゲート先のオブジェクトの動作を受け入れる必要があります。Your CollectionView must accept the behavior of the object to which it delegates. この場合は、適切なCanChange* プロパティを falseに設定します。In this case, set the appropriate CanChange* properties to false. CollectionView が、デリゲートオブジェクトがライブ整形をサポートするかどうかを認識している場合は、適切な IsLive* プロパティを既知の値に設定できます。If your CollectionView knows whether the delegate object supports live shaping, it can set the appropriate IsLive* properties to the known value. それ以外の場合は、CollectionViewIsLive* プロパティを nullに設定する必要があります。Otherwise, the CollectionView should set the IsLive* properties to null.

プロパティ

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.

適用対象