ItemCollection Osztály

Definíció

Névtér:

System.Windows.Controls

Szerelvény:

PresentationFramework.dll

Tartalmazza azoknak az elemeknek a listáját, amelyek egy adott elem tartalmát alkotják ItemsControl.

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.ICollectionViewLiveShaping, System.ComponentModel.IEditableCollectionViewAddNewItem, System.ComponentModel.IItemProperties, System.Windows.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 ICollectionViewLiveShaping, IEditableCollectionViewAddNewItem, IItemProperties, IList, IWeakEventListener

Öröklődés

Object

DispatcherObject

CollectionView

ItemCollection

Attribútumok

LocalizabilityAttribute

Megvalósítás

ICollection IEnumerable IList IEditableCollectionView IItemProperties IWeakEventListener IEditableCollectionViewAddNewItem ICollectionViewLiveShaping

Példák

Ha rendelkezik ItemsControlListBox tartalommal, akkor a Items tulajdonság használatával elérheti a ItemCollectionnézetet. Mivel ez egy nézet, használhatja a nézettel kapcsolatos funkciókat, például a rendezést, a szűrést és a csoportosítást. Vegye figyelembe, hogy amikor az ItemsSource be van állítva, a nézetműveletek delegálva lesznek a nézetre az ItemsSource-gyűjteményen keresztül. Az ItemCollection ezért csak akkor támogatja a rendezést, a szűrést és a csoportosítást, ha a delegált nézet támogatja őket.

Az alábbi példa bemutatja, hogyan rendezheti egy elnevezett ListBoxtartalom tartalmátmyListBox. Ebben a példában Content a rendezendő tulajdonság neve.

myListBox.Items.SortDescriptions.Add(
    new SortDescription("Content", ListSortDirection.Descending));

myListBox.Items.SortDescriptions.Add(New SortDescription("Content", ListSortDirection.Descending))

Ha ezt teszi, előfordulhat, hogy a nézet az alapértelmezett nézet, attól függően, hogy az adatok hogyan lesznek beállítva az Önén ItemsControl. Ha például a ItemsSource tulajdonság egyhez CollectionViewSourcevan kötve, a tulajdonság használatával Items beszerzett nézet nem az alapértelmezett nézet.

Ha kötött ItemsControl (a tulajdonságot ItemsSource használja), akkor az alábbi műveleteket hajthatja végre az alapértelmezett nézet lekéréséhez:

CollectionView myView;

Private myView As CollectionView

myView = (CollectionView)CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource);

myView = CType(CollectionViewSource.GetDefaultView(myItemsControl.ItemsSource), CollectionView)

Másik lehetőségként megadhatja a szűrési, rendezési és csoportosítási feltételeket az XAML használatával CollectionViewSource.

Megjegyzések

ItemCollection olyan elemek gyűjteményét tartja fenn, mint a sztringek, objektumok, XML-csomópontok, elemek és egyéb gyűjtemények. Az an ItemsControl a benne lévő adatokat használja a ItemCollection tartalom létrehozásához. Ha egynél több gyűjteményt szeretne összesíteni, rendeljen hozzá egyet CompositeCollection a ItemsSource tulajdonságához ItemsControl.

Használja a Items tulajdonságot vagy a ItemsSource tulajdonságot annak a gyűjteménynek a megadásához, amelyet a ItemsControltartalom létrehozásához használni kell. ItemsSource A tulajdonság beállításakor a Items gyűjtemény írásvédett és rögzített méretű lesz. Ez azt jelenti, hogy ha a tulajdonságot ItemsSource használja, közvetlenül nem adhat hozzá, törölhet vagy módosíthat elemeket ItemCollection .

ItemCollection CollectionView gyűjteménynézeti funkciók, például rendezés, csoportosítás és szűrés. További információ: SortDescriptions, Filterés GroupDescriptions.

A gyűjteménynézetekről további információt az Adatkötés áttekintése című témakörben talál.

Tulajdonságok

Name	Description
AllowsCrossThreadChanges	Olyan értéket kap, amely azt jelzi, hogy az azt létrehozótól eltérő szál módosíthatja-e a CollectionViewSourceCollection. (Öröklődés forrása CollectionView)
CanChangeLiveFiltering	Olyan értéket kap, amely jelzi, hogy a gyűjteménynézet támogatja-e az adatok valós idejű be- vagy kikapcsolását.
CanChangeLiveGrouping	Olyan értéket kap, amely jelzi, hogy a gyűjteménynézet támogatja-e az adatok valós idejű be- vagy kikapcsolását.
CanChangeLiveSorting	Olyan értéket kap, amely jelzi, hogy a gyűjteménynézet támogatja-e az adatok valós idejű be- vagy kikapcsolását.
CanFilter	Olyan értéket kap, amely jelzi, hogy ez a gyűjteménynézet támogatja-e a szűrést.
CanGroup	Olyan értéket kap, amely jelzi, hogy ez a gyűjteménynézet támogatja-e a csoportosítást.
CanSort	Olyan értéket kap, amely jelzi, hogy ez a gyűjteménynézet támogatja-e a rendezést.
Comparer	Egy objektumot ad vissza, amellyel összehasonlíthatja a nézetben lévő elemeket. (Öröklődés forrása CollectionView)
Count	Lekéri a gyűjtemény rekordjainak számát.
Culture	Lekéri vagy beállítja a rendezés során használni kívánt kulturális információkat. (Öröklődés forrása CollectionView)
CurrentItem	Lekéri az aktuális elemet a nézetben.
CurrentPosition	Lekéri az aktuális elem sorszámát a nézetben.
Dispatcher	Lekérdezi, Dispatcher hogy ez a társítva van-e DispatcherObject . (Öröklődés forrása DispatcherObject)
Filter	Lekéri vagy beállítja a visszahívást annak megállapítására, hogy egy elem alkalmas-e a nézetbe való felvételre.
GroupDescriptions	Lekéri az elemek csoportosítását GroupDescription meghatározó objektumgyűjteményt.
Groups	Lekéri azokat a legfelső szintű csoportokat, amelyek a GroupDescriptions.
IsCurrentAfterLast	Olyan értéket kap, amely jelzi, hogy a nézet aktuális eleme túl van-e a gyűjtemény végén.
IsCurrentBeforeFirst	Olyan értéket kap, amely jelzi, hogy a nézet aktuális eleme túl van-e a gyűjtemény elején.
IsCurrentInSync	Olyan értéket kap, amely jelzi, hogy a CurrentItemCurrentPosition. (Öröklődés forrása CollectionView)
IsDynamic	Lekéri azt az értéket, amely jelzi, hogy az alapul szolgáló gyűjtemény módosítási értesítéseket biztosít-e. (Öröklődés forrása CollectionView)
IsEmpty	Olyan értéket kap, amely jelzi, hogy az eredményül kapott (szűrt) nézet üres-e.
IsInUse	Olyan értéket kap, amely jelzi, hogy egy objektum feliratkozik-e ennek CollectionViewaz eseménynek az eseményeire. (Öröklődés forrása CollectionView)
IsLiveFiltering	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezve van-e az adatok valós idejű szűrése.
IsLiveGrouping	Lekéri vagy beállít egy értéket, amely jelzi, hogy engedélyezve van-e az adatok valós idejű csoportosítása.
IsLiveSorting	Lekéri vagy beállít egy értéket, amely jelzi, hogy a rendezés valós időben engedélyezve van-e.
IsRefreshDeferred	Olyan értéket kap, amely jelzi, hogy van-e használatban függőben DeferRefresh() lévő érték. (Öröklődés forrása CollectionView)
Item[Int32]	Lekéri vagy beállítja az elemet a megadott nulla alapú indexen.
LiveFilteringProperties	Sztringgyűjteményt kap, amely megadja az adatok valós idejű szűrésében részt vevő tulajdonságokat.
LiveGroupingProperties	Sztringgyűjteményt kap, amely valós időben adja meg az adatok csoportosításában részt vevő tulajdonságokat.
LiveSortingProperties	Sztringgyűjteményt kap, amely megadja az adatok valós idejű rendezésében részt vevő tulajdonságokat.
NeedsRefresh	Olyan értéket kap, amely jelzi, hogy frissíteni kell-e a gyűjteményt.
SortDescriptions	Olyan objektumgyűjteményt SortDescription kap, amely leírja, hogy a gyűjtemény elemei hogyan vannak rendezve a nézetben.
SourceCollection	Lekéri a gyűjteménynézet alapjául képező szűretlen és szűretlen gyűjteményt.
UpdatedOutsideDispatcher	Olyan értéket kap, amely jelzi, hogy szükséges volt-e frissíteni a változásnaplót, mert egy CollectionChanged másik szálra érkezett értesítés anélkül, hogy először be kellett volna lépnie a felhasználói felület (UI) szál-diszpécserébe. (Öröklődés forrása CollectionView)

Metódusok

Name	Description
Add(Object)	Elemet ad hozzá a ItemCollection.
CheckAccess()	Meghatározza, hogy a hívó szál hozzáfér-e ehhez DispatcherObject. (Öröklődés forrása DispatcherObject)
Clear()	Törli a gyűjteményt, és felszabadítja a hivatkozásokat a gyűjteményben lévő összes elemen.
ClearChangeLog()	Elavult. Törli a függőben lévő módosításokat a változásnaplóból. (Öröklődés forrása CollectionView)
ClearPendingChanges()	Törli a gyűjteményre módosított feldolgozatlanokat. (Öröklődés forrása CollectionView)
Contains(Object)	Egy értéket ad vissza, amely jelzi, hogy a megadott elem szerepel-e ebben a nézetben.
CopyTo(Array, Int32)	A gyűjtemény elemeit egy tömbbe másolja egy adott tömbindextől kezdve.
DeferRefresh()	Halasztási ciklust ad meg, amellyel egyesítheti a nézet módosításait, és késleltetheti az automatikus frissítést.
DetachFromSourceCollection()	Eltávolítja a mögöttes gyűjteményre mutató hivatkozást a CollectionView. (Öröklődés forrása CollectionView)
GetEnumerator()	Egy objektumot ad vissza, amellyel számba vehet elemeket a nézetben. (Öröklődés forrása CollectionView)
GetItemAt(Int32)	Ebben a nézetben a megadott nulla alapú indexben lévő elemet adja vissza.
IndexOf(Object)	A gyűjtemény azon indexét adja vissza, amelyben a megadott elem található.
Insert(Int32, Object)	Elemet szúr be a gyűjteménybe a megadott indexben.
MoveCurrentTo(Object)	A gyűjteményben megadott elemet állítja be .CurrentItem
MoveCurrentToFirst()	A nézet első elemét állítja be .CurrentItem
MoveCurrentToLast()	A nézetben az utolsó elemet állítja be .CurrentItem
MoveCurrentToNext()	Beállítja az elemet a CurrentItem nézetben a következőként CurrentItem: .
MoveCurrentToPosition(Int32)	Beállítja, hogy az elem a megadott indexben legyen a CurrentItem nézetben.
MoveCurrentToPrevious()	Beállítja az elemet a CurrentItem nézetben CurrentItem.
OKToChangeCurrent()	Olyan értéket ad vissza, amely jelzi, hogy a nézet módosíthatja-e, hogy melyik elem a CurrentItem. (Öröklődés forrása CollectionView)
OnAllowsCrossThreadChangesChanged()	A tulajdonság megváltozásakor AllowsCrossThreadChanges fordul elő. (Öröklődés forrása CollectionView)
OnBeginChangeLogging(NotifyCollectionChangedEventArgs)	Elavult. Az alaposztály meghívta, hogy értesítse a származtatott osztályt arról, hogy egy CollectionChanged eseményt közzétettek az üzenetsorba. (Öröklődés forrása CollectionView)
OnCollectionChanged(NotifyCollectionChangedEventArgs)	Az eseményt emeli CollectionChanged ki. (Öröklődés forrása CollectionView)
OnCollectionChanged(Object, NotifyCollectionChangedEventArgs)	Az eseményt emeli CollectionChanged ki. (Öröklődés forrása CollectionView)
OnCurrentChanged()	Az eseményt emeli CurrentChanged ki. (Öröklődés forrása CollectionView)
OnCurrentChanging()	Olyan eseményt CurrentChanging hoz létre, amely nem törölhető. (Öröklődés forrása CollectionView)
OnCurrentChanging(CurrentChangingEventArgs)	Az eseményt a CurrentChanging megadott argumentumokkal emeli ki. (Öröklődés forrása CollectionView)
OnPropertyChanged(PropertyChangedEventArgs)	Az eseményt a PropertyChanged megadott argumentumokkal emeli ki. (Öröklődés forrása CollectionView)
PassesFilter(Object)	Olyan értéket ad vissza, amely jelzi, hogy a megadott elem ebbe a nézetbe tartozik-e.
ProcessCollectionChanged(NotifyCollectionChangedEventArgs)	Ha egy származtatott osztályban felül van bírálva, a felhasználói felület szálán egyetlen módosítást dolgoz fel. (Öröklődés forrása CollectionView)
ProcessPendingChanges()	Biztosítja, hogy a gyűjtemény összes függőben lévő módosítása véglegesítése megtörtént. (Öröklődés forrása CollectionView)
Refresh()	Hozza létre újra a nézetet. (Öröklődés forrása CollectionView)
RefreshOrDefer()	Frissíti a nézetet, vagy megadja, hogy a nézetet frissíteni kell a halasztási ciklus befejeződésekor. (Öröklődés forrása CollectionView)
RefreshOverride()	Hozza létre újra a nézetet. (Öröklődés forrása CollectionView)
Remove(Object)	Eltávolítja a megadott elemhivatkozást a gyűjteményből vagy nézetből.
RemoveAt(Int32)	Eltávolítja az elemet a gyűjtemény vagy nézet megadott indexéből.
SetCurrent(Object, Int32, Int32)	Beállítja a megadott elemet és indexet a CurrentItem tulajdonságok értékeiként CurrentPosition . Ez a metódus egy származtatott osztály konstruktorából hívható meg. (Öröklődés forrása CollectionView)
SetCurrent(Object, Int32)	Beállítja a megadott elemet és indexet a CurrentItem tulajdonságok értékeiként CurrentPosition . (Öröklődés forrása CollectionView)
VerifyAccess()	Kényszeríti, hogy a hívószál hozzáférhessen ehhez.DispatcherObject (Öröklődés forrása DispatcherObject)

esemény

Name	Description
CollectionChanged	Akkor fordul elő, ha a nézet megváltozott. (Öröklődés forrása CollectionView)
CurrentChanged	A módosítás után CurrentItem következik be. (Öröklődés forrása CollectionView)
CurrentChanging	A változókor CurrentItem következik be. (Öröklődés forrása CollectionView)
PropertyChanged	Akkor fordul elő, ha egy tulajdonság értéke megváltozott. (Öröklődés forrása CollectionView)

Explicit interfész-implementációk

Name	Description
ICollection.IsSynchronized	Ez a tag támogatja a Windows megjelenítési alaprendszer (WPF) infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
ICollection.SyncRoot	Ez a tag támogatja a Windows megjelenítési alaprendszer (WPF) infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
IEditableCollectionView.AddNew()	Új elemet ad hozzá a gyűjteményhez.
IEditableCollectionView.CanAddNew	Beolvas egy értéket, amely jelzi, hogy hozzáadható-e új elem a gyűjteményhez.
IEditableCollectionView.CanCancelEdit	Olyan értéket kap, amely jelzi, hogy a gyűjteménynézet elvetheti-e a függőben lévő módosításokat, és visszaállíthatja-e egy szerkesztett objektum eredeti értékeit.
IEditableCollectionView.CancelEdit()	Befejezi a szerkesztési tranzakciót, és ha lehetséges, visszaállítja az eredeti értéket az elemre.
IEditableCollectionView.CancelNew()	A tranzakció hozzáadása véget ér, és elveti a függőben lévő új elemet.
IEditableCollectionView.CanRemove	Olyan értéket kap, amely jelzi, hogy eltávolítható-e egy elem a gyűjteményből.
IEditableCollectionView.CommitEdit()	Befejezi a szerkesztési tranzakciót, és menti a függőben lévő módosításokat.
IEditableCollectionView.CommitNew()	A tranzakció hozzáadása véget ér, és menti a függőben lévő új elemet.
IEditableCollectionView.CurrentAddItem	Lekéri az aktuális hozzáadási tranzakció során hozzáadott elemet.
IEditableCollectionView.CurrentEditItem	Lekéri a szerkesztett gyűjteményben lévő elemet.
IEditableCollectionView.EditItem(Object)	Elindítja a megadott elem szerkesztési tranzakcióját.
IEditableCollectionView.IsAddingNew	Olyan értéket kap, amely jelzi, hogy folyamatban van-e a hozzáadási tranzakció.
IEditableCollectionView.IsEditingItem	Beolvas egy értéket, amely jelzi, hogy egy szerkesztési tranzakció folyamatban van-e.
IEditableCollectionView.NewItemPlaceholderPosition	Lekéri vagy beállítja az új elem helyőrzőjének helyét a gyűjteménynézetben.
IEditableCollectionView.Remove(Object)	Eltávolítja a megadott elemet a gyűjteményből.
IEditableCollectionView.RemoveAt(Int32)	Eltávolítja a megadott helyen lévő elemet a gyűjteményből.
IEditableCollectionViewAddNewItem.AddNewItem(Object)	Hozzáadja a megadott objektumot a gyűjteményhez.
IEditableCollectionViewAddNewItem.CanAddNewItem	Olyan értéket kap, amely jelzi, hogy egy adott objektum hozzáadható-e a gyűjteményhez.
IEnumerable.GetEnumerator()	Egy IEnumerator objektumot ad vissza, amellyel számba vehet elemeket a nézetben. (Öröklődés forrása CollectionView)
IItemProperties.ItemProperties	Beolvas egy gyűjteményt, amely információkat tartalmaz a gyűjtemény elemein elérhető tulajdonságokról.
IList.IsFixedSize	Ez a tag támogatja a Windows megjelenítési alaprendszer (WPF) infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
IList.IsReadOnly	Ez a tag támogatja a Windows megjelenítési alaprendszer (WPF) infrastruktúrát, és nem közvetlenül a kódból való használatra szolgál.
INotifyCollectionChanged.CollectionChanged	Akkor fordul elő, ha a nézet megváltozott. (Öröklődés forrása CollectionView)
INotifyPropertyChanged.PropertyChanged	Akkor fordul elő, ha egy tulajdonság értéke megváltozik. (Öröklődés forrása CollectionView)
IWeakEventListener.ReceiveWeakEvent(Type, Object, EventArgs)	Eseményeket fogad a központosított eseménykezelőtől.

Lásd még

• ItemsControl