UIElementCollection Class (System.Windows.Controls)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework 3.0

.NET Framework Class Library

UIElementCollection Class

Updated: November 2007

Represents an ordered collection of UIElements.

Namespace: System.Windows.Controls
Assembly: PresentationFramework (in PresentationFramework.dll)

Syntax

Visual Basic (Declaration)

Public Class UIElementCollection _
    Implements IList, ICollection, IEnumerable

Visual Basic (Usage)

Dim instance As UIElementCollection

public class UIElementCollection : IList, 
    ICollection, IEnumerable

Visual C++

public ref class UIElementCollection : IList, 
    ICollection, IEnumerable

public class UIElementCollection implements IList, 
    ICollection, IEnumerable

JScript

public class UIElementCollection implements IList, ICollection, IEnumerable

XAML

You cannot directly create an instance of this class in XAML.

Remarks

The Panel base class uses a UIElementCollection to represent its collection of child elements. Methods and properties defined by the UIElementCollection affect all objects derived from Panel and define a common feature-set for the manipulation of Panel child elements.

A UIElementCollection has affinity to its own context (class). You must access the collection from the context of the owning Panel.

Examples

The following example uses the Add method to add child content to a parent StackPanel. You do this by using the Children property, which is of type UIElementCollection. For the complete sample, see Using Elements Sample.

        void AddButton(object sender, MouseButtonEventArgs e)
        {
            sp1.Children.Clear();
            btn = new Button();
            btn.Content = "New Button";
            sp1.Children.Add(btn);
        }

Inheritance Hierarchy

System..::.Object
System.Windows.Controls..::.UIElementCollection

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows Vista

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information