ItemCollection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ItemsControl のコンテンツを構成する項目のリストを保持します。
public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::IEditableCollectionView, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener
public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener
public ref class ItemCollection sealed : System::Windows::Data::CollectionView, System::Collections::IList, System::ComponentModel::ICollectionViewLiveShaping, System::ComponentModel::IEditableCollectionViewAddNewItem, System::ComponentModel::IItemProperties, System::Windows::IWeakEventListener
[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
public sealed class ItemCollection : System.Windows.Data.CollectionView, System.Collections.IList, System.ComponentModel.IEditableCollectionView, System.ComponentModel.IItemProperties, System.Windows.IWeakEventListener
[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
public sealed class ItemCollection : System.Windows.Data.CollectionView, System.Collections.IList, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties, System.Windows.IWeakEventListener
[System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)]
public sealed class ItemCollection : System.Windows.Data.CollectionView, System.Collections.IList, System.ComponentModel.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties, System.Windows.IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
inherit CollectionView
interface IList
interface ICollection
interface IEnumerable
interface IEditableCollectionView
interface IItemProperties
interface IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
inherit CollectionView
interface IList
interface ICollection
interface IEnumerable
interface IEditableCollectionViewAddNewItem
interface IEditableCollectionView
interface IItemProperties
interface IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
inherit CollectionView
interface IList
interface ICollection
interface IEnumerable
interface IEditableCollectionViewAddNewItem
interface IEditableCollectionView
interface ICollectionViewLiveShaping
interface IItemProperties
interface IWeakEventListener
[<System.Windows.Localizability(System.Windows.LocalizationCategory.Ignore)>]
type ItemCollection = class
inherit CollectionView
interface ICollection
interface IEnumerable
interface IList
interface ICollectionViewLiveShaping
interface IEditableCollectionView
interface IEditableCollectionViewAddNewItem
interface IItemProperties
interface IWeakEventListener
Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements IEditableCollectionView, IItemProperties, IList, IWeakEventListener
Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener
Public NotInheritable Class ItemCollection
Inherits CollectionView
Implements ICollectionViewLiveShaping, IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener
- 継承
- 属性
- 実装
例
コンテンツを含む などの ListBox があるItemsControl場合は、 プロパティをItems使用して、 ビューである にItemCollectionアクセスできます。 ビューであるため、並べ替え、フィルター処理、グループ化などのビュー関連の機能を使用できます。 ItemsSource が設定されている場合、ビュー操作は ItemsSource コレクションのビューに委任されることに注意してください。 したがって、ItemCollection では、委任されたビューでサポートされている場合にのみ、並べ替え、フィルター処理、およびグループ化がサポートされます。
次の例は、 という名前myListBox
の のコンテンツを並べ替える方法をListBox示しています。 この例では、 Content
は並べ替えの基準となるプロパティの名前です。
myListBox.Items.SortDescriptions.Add(
new SortDescription("Content", ListSortDirection.Descending));
myListBox.Items.SortDescriptions.Add(New SortDescription("Content", ListSortDirection.Descending))
これを行う場合、データの設定方法 ItemsControlによっては、ビューが既定のビューになる場合とそうでない場合があります。 たとえば、 プロパティが ItemsSource に CollectionViewSourceバインドされている場合、 プロパティを使用して Items 取得するビューは既定のビューではありません。
ItemsControlがバインドされている場合 (プロパティをItemsSource使用している場合)、次の操作を実行して既定のビューを取得できます。
CollectionView myView;
Private myView As CollectionView
myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);
myView = CType(CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource), CollectionView)
または、 を使用して XAML でフィルター処理、並べ替え、グループ化の条件を CollectionViewSource指定することもできます。
注釈
ItemCollection は、文字列、オブジェクト、XML ノード、要素、その他のコレクションなどの項目のコレクションを保持します。 では ItemsControl 、 の ItemCollection データを使用してそのコンテンツを生成します。 複数のコレクションを集計する場合は、 の プロパティItemsControlに をItemsSource割り当てますCompositeCollection。
のコンテンツを Items 生成するために使用するコレクションを指定するには、 プロパティまたは ItemsSource プロパティを使用します ItemsControl。 プロパティを ItemsSource 設定すると、コレクションは Items 読み取り専用および固定サイズになります。 つまり、 プロパティを ItemsSource 使用している場合は、 内の ItemCollection 項目を直接追加、削除、または変更することはできません。
ItemCollection CollectionViewは であるため、並べ替え、グループ化、フィルター処理などのコレクション ビュー機能が提供されます。 詳細については、「SortDescriptions「Filterおよび「GroupDescriptions」を参照してください。
コレクション ビューの詳細については、「 データ バインディングの概要」を参照してください。
プロパティ
AllowsCrossThreadChanges |
CollectionView を作成したスレッド以外のスレッドが SourceCollection を変更できるかどうかを示す値を取得します。 (継承元 CollectionView) |
CanChangeLiveFiltering |
コレクション ビューがデータのリアルタイム フィルター処理のオン/オフ切り替えをサポートしているかどうかを示す値を取得します。 |
CanChangeLiveGrouping |
コレクション ビューがリアルタイムのデータのグループ化のオンまたはオフをサポートするかどうかを示す値を取得します。 |
CanChangeLiveSorting |
コレクション ビューがリアルタイムのデータの並べ替えのオンまたはオフをサポートするかどうかを示す値を取得します。 |
CanFilter |
このコレクション ビューでフィルター処理がサポートされるかどうかを示す値を取得します。 |
CanGroup |
このコレクション ビューでグループ化がサポートされるかどうかを示す値を取得します。 |
CanSort |
このコレクション ビューで並べ替えがサポートされるかどうかを示す値を取得します。 |
Comparer |
ビュー内の項目を比較するために使用できるオブジェクトを返します。 (継承元 CollectionView) |
Count |
コレクション内のレコード数を取得します。 |
Culture |
並べ替え中に使用するカルチャ情報を取得または設定します。 (継承元 CollectionView) |
CurrentItem |
ビュー内の現在の項目を取得します。 |
CurrentPosition |
ビュー内の現在の項目の位置を表す序数を取得します。 |
Dispatcher |
この Dispatcher が関連付けられている DispatcherObject を取得します。 (継承元 DispatcherObject) |
Filter |
項目をビューに含めることが適切であるかどうかを決定するために使用されるコールバックを取得または設定します。 |
GroupDescriptions |
項目をグループ化する方法を定義する GroupDescription オブジェクトのコレクションを取得します。 |
Groups |
GroupDescriptions に従って構築されるトップレベル グループを取得します。 |
IsCurrentAfterLast |
ビューの現在の項目がコレクションの末尾を越えるかどうかを示す値を取得します。 |
IsCurrentBeforeFirst |
ビューの現在の項目がコレクションの先頭を越えるかどうかを示す値を取得します。 |
IsCurrentInSync |
CurrentItem が CurrentPosition にあるかどうかを示す値を取得します。 (継承元 CollectionView) |
IsDynamic |
基になるコレクションが変更通知機能を持つかどうかを示す値を取得します。 (継承元 CollectionView) |
IsEmpty |
結果の (フィルター処理された) ビューが空かどうかを示す値を取得します。 |
IsInUse |
この CollectionView オブジェクトのイベントをサブスクライブしているオブジェクトがあるかどうかを示す値を取得します。 (継承元 CollectionView) |
IsLiveFiltering |
リアルタイムでのデータのフィルター処理が有効かどうかを示す値を取得または設定します。 |
IsLiveGrouping |
リアルタイムでのデータのグループ化が有効かどうかを示す値を取得または設定します。 |
IsLiveSorting |
リアルタイムでの並べ替えが有効かどうかを示す値を取得または設定します。 |
IsRefreshDeferred |
保留状態の DeferRefresh() が使用されているかどうかを示す値を取得します。 (継承元 CollectionView) |
Item[Int32] |
指定された 0 から始まるインデックス位置にある項目を取得または設定します。 |
LiveFilteringProperties |
リアルタイムのデータのフィルター選択に関係するプロパティを指定する文字列のコレクションを取得します。 |
LiveGroupingProperties |
リアルタイムのデータのグループ化に関係するプロパティを指定する文字列のコレクションを取得します。 |
LiveSortingProperties |
リアルタイムのデータの並べ替えに関係するプロパティを指定する文字列のコレクションを取得します。 |
NeedsRefresh |
コレクションを更新する必要があるかどうかを示す値を取得します。 |
SortDescriptions |
コレクション内の項目をビュー内でどのように並べ替えるかを説明する SortDescription オブジェクトのコレクションを取得します。 |
SourceCollection |
このコレクション ビューの基になる、並べ替えおよびフィルター処理が行われていないコレクションを取得します。 |
UpdatedOutsideDispatcher |
最初にユーザー インターフェイス (UI) スレッド ディスパッチャーに入らずに別のスレッドで通知を CollectionChanged 受信したために、変更ログを更新する必要があるかどうかを示す値を取得します。 (継承元 CollectionView) |
メソッド
イベント
CollectionChanged |
ビューが変化すると発生します。 (継承元 CollectionView) |
CurrentChanged |
CurrentItem が変更された後に発生します。 (継承元 CollectionView) |
CurrentChanging |
CurrentItem が変更されているときに発生します。 (継承元 CollectionView) |
PropertyChanged |
プロパティ値が変更されたときに発生します。 (継承元 CollectionView) |
明示的なインターフェイスの実装
ICollection.IsSynchronized |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 |
ICollection.SyncRoot |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 |
IEditableCollectionView.AddNew() |
新しい項目をコレクションに追加します。 |
IEditableCollectionView.CanAddNew |
新しい項目をコレクションに追加できるかどうかを示す値を取得します。 |
IEditableCollectionView.CanCancelEdit |
コレクション ビューが保留中の変更を破棄して、編集されたオブジェクトの元の値を復元できるかどうかを示す値を取得します。 |
IEditableCollectionView.CancelEdit() |
編集トランザクションを終了し、可能な場合は、項目の元の値を復元します。 |
IEditableCollectionView.CancelNew() |
追加トランザクションを終了し、保留中の新しい項目を破棄します。 |
IEditableCollectionView.CanRemove |
コレクションから項目を削除できるかどうかを示す値を取得します。 |
IEditableCollectionView.CommitEdit() |
編集トランザクションを終了し、保留中の変更を保存します。 |
IEditableCollectionView.CommitNew() |
追加トランザクションを終了し、保留中の新しい項目を保存します。 |
IEditableCollectionView.CurrentAddItem |
現在の追加トランザクション処理中に追加される項目を取得します。 |
IEditableCollectionView.CurrentEditItem |
編集されているコレクション内の項目を取得します。 |
IEditableCollectionView.EditItem(Object) |
指定した項目の編集トランザクションを開始します。 |
IEditableCollectionView.IsAddingNew |
追加トランザクションが実行中かどうかを示す値を取得します。 |
IEditableCollectionView.IsEditingItem |
編集トランザクションが実行中かどうかを示す値を取得します。 |
IEditableCollectionView.NewItemPlaceholderPosition |
コレクション ビューにある新しい項目のプレースホルダーの位置を取得または設定します。 |
IEditableCollectionView.Remove(Object) |
指定した項目をコレクションから削除します。 |
IEditableCollectionView.RemoveAt(Int32) |
コレクション内の指定した位置にある項目を削除します。 |
IEditableCollectionViewAddNewItem.AddNewItem(Object) |
指定したオブジェクトをコレクションに追加します。 |
IEditableCollectionViewAddNewItem.CanAddNewItem |
指定したオブジェクトをコレクションに追加できるかどうかを示す値を取得します。 |
IEnumerable.GetEnumerator() |
ビュー内の項目を列挙するために使用できる IEnumerator オブジェクトを返します。 (継承元 CollectionView) |
IItemProperties.ItemProperties |
コレクション内の項目で使用できるプロパティに関する情報を格納するコレクションを取得します。 |
IList.IsFixedSize |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 |
IList.IsReadOnly |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用することを意図したものではありません。 |
INotifyCollectionChanged.CollectionChanged |
ビューが変化すると発生します。 (継承元 CollectionView) |
INotifyPropertyChanged.PropertyChanged |
プロパティ値が変更するときに発生します。 (継承元 CollectionView) |
IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs) |
中央のイベント マネージャーからイベントを受信します。 |
拡張メソッド
Cast<TResult>(IEnumerable) |
IEnumerable の要素を、指定した型にキャストします。 |
OfType<TResult>(IEnumerable) |
指定された型に基づいて IEnumerable の要素をフィルター処理します。 |
AsParallel(IEnumerable) |
クエリの並列化を有効にします。 |
AsQueryable(IEnumerable) |
IEnumerable を IQueryable に変換します。 |
適用対象
こちらもご覧ください
.NET