UIElementCollection Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml.Controls
Modifica

Rappresenta una raccolta ordinata di oggetti UIElement .

public ref class UIElementCollection sealed : IIterable<UIElement ^>, IVector<UIElement ^>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UIElementCollection final : IIterable<UIElement>, IVector<UIElement>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class UIElementCollection final : IIterable<UIElement>, IVector<UIElement>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class UIElementCollection : IEnumerable<UIElement>, IList<UIElement>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class UIElementCollection : IEnumerable<UIElement>, IList<UIElement>
Public NotInheritable Class UIElementCollection
Implements IEnumerable(Of UIElement), IList(Of UIElement)
<panelobject>
  oneOrMoreChildren
</panelobject>
Ereditarietà
Object Platform::Object IInspectable UIElementCollection
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementazioni
IIterable<T> IEnumerable<T> IIterable<UIElement> IEnumerable<UIElement> IVector<UIElement> IList<UIElement>

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

UiElementCollection è il tipo di oggetto ottenuto dalla proprietà Children di un oggetto Panel. Ad esempio, se si ottiene un valore da Grid.Children, tale valore è un'istanza UIElementCollection. Tutte le proprietà che usano un oggetto UIElementCollection nell'API Windows Runtime sono proprietà di sola lettura, in cui la proprietà viene inizializzata con zero elementi quando viene creata per la prima volta un'istanza di un oggetto. È tuttavia possibile aggiungere, rimuovere o eseguire query sugli elementi nella raccolta in fase di esecuzione usando le proprietà e i metodi UIElementCollection.

Il tipo degli elementi in UIElementCollection è vincolato come UIElement. UIElement è tuttavia una classe di elementi di base in Windows Runtime usando XAML, quindi ci sono centinaia di tipi di elementi che possono essere considerati come uiElement e possono quindi essere uno degli elementi in un oggetto UIElementCollection.

Enumerazione della raccolta in C# o Microsoft Visual Basic

UiElementCollection è enumerabile, quindi è possibile usare una sintassi specifica del linguaggio, ad esempio foreach in C# per enumerare gli elementi in UIElementCollection. Il compilatore esegue automaticamente il cast dei tipi e non è necessario eseguire il cast in IEnumerable<UIElement> modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast a IEnumerable<T> con un vincolo UIElement .

Proprietà

Size

Ottiene le dimensioni (conteggio) dell'insieme.

Metodi

Append(UIElement)

Aggiunge un nuovo elemento alla raccolta.
Clear()

Rimuove tutti gli elementi dalla raccolta.
First()

Restituisce l'oggetto iteratore che può scorrere gli elementi in UIElementCollection.
GetAt(UInt32)

Restituisce l'elemento che si trova in corrispondenza dell'indice specificato.
GetMany(UInt32, UIElement[])

Recupera più elementi in un singolo pass-through dell'iteratore.
GetView()

Ottiene una visualizzazione non modificabile nella raccolta.
IndexOf(UIElement, UInt32)

Recupera l'indice dell'elemento specificato.
InsertAt(UInt32, UIElement)

Inserisce l'elemento specificato in corrispondenza dell'indice specificato.
Move(UInt32, UInt32)

Sposta l'elemento in corrispondenza dell'indice specificato in un nuova posizione nella raccolta.
RemoveAt(UInt32)

Rimuove l'elemento all'indice specificato.
RemoveAtEnd()

Rimuove l'ultimo elemento nella raccolta.
ReplaceAll(UIElement[])

Cancella inizialmente la raccolta, quindi inserisce la matrice specificata come nuovi elementi.
SetAt(UInt32, UIElement)

Imposta il valore in corrispondenza dell'indice specificato sul valore UIElement specificato.

Si applica a

Vedi anche