UIElementCollection Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- Attributi
- Implementazioni
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. |