Panel.Children Property (System.Windows.Controls)

Children Property

Switch on low bandwidth view

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 Class Library

Panel..::.Children Property

Gets a UIElementCollection of child elements of this Panel.

Namespace: System.Windows.Controls
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/xaml/presentation

Syntax

Visual Basic (Declaration)

Public ReadOnly Property Children As UIElementCollection

Visual Basic (Usage)

Dim instance As Panel
Dim value As UIElementCollection

value = instance.Children

public UIElementCollection Children { get; }

Visual C++

public:
property UIElementCollection^ Children {
    UIElementCollection^ get ();
}

JScript

public function get Children () : UIElementCollection

XAML Content Element Usage

<object>
  <UIElementCollection .../>
</object>

Property Value

Type: System.Windows.Controls..::.UIElementCollection
A UIElementCollection. The default is an empty UIElementCollection.

Remarks

Content Model: Panel enforces a strong content model for child content. The Children collection of a Panel element can only consist of UIElement objects. Adding a UIElement child to a Panel implicitly adds it to the UIElementCollection for the Panel element.

Do not use this collection with derived Panel classes; use the InternalChildren collection instead.

This property returns nullNothingnullptra null reference (Nothing in Visual Basic) if the Panel is data bound.

Examples

The following code example demonstrates how to use the Children property to add a UIElement child to a Panel element.

StackPanel myStackPanel = new StackPanel();
Button myButton = new Button();
myButton.Content = "Press me";
myStackPanel.Children.Add(myButton);

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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

.NET Framework

Supported in: 3.5, 3.0

Reference

Panel Class

Panel Members

System.Windows.Controls Namespace

UIElement

Other Resources

Panels Overview

Using Elements Sample